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Chapter 1 


Introduction 


The aim of this book is to introduce BTgX to a non-technical person. ETgX 
is excellent for producing professional looking documents, however it is a 
language not a word processor, so it can take a bit of getting used to, partic- 
ularly if you hâve never had any expérience using programming languages. 

ETgX does take a while to learn, so why should you use it? Here are a 
few reasons but it is not an exhaustive list: 

ETp;X is far better at typesetting mathematical équations than word pro- 
cessors. I wrote my Ph.D. thesis back in the days of ETp;X2.09 (the old 
version of ETjrX) and given the high quantity of mathematics that I had to 
typeset, it would hâve taken me considerably longer to write it in a word 
processor, and the resulting document wouldn't hâve looked nearly as good. 
Even Microsoft hâve acknowledged TgX's high-quality mathematical typog- 
raphy [12]. 

Example: 

Elere's an équation taken from some kernel survival analysis: 



(You can find out how to create this équation on page 161 in Section 9.4.9.) 

That's ail very well and good if you want to typeset some équations, but if 
your work doesn't involve maths, does that mean that ETgX is not for you? 
Although I am a mathematician, I hâve written plenty of documents with no 
maths in at ail, including prose, poetry, newsletters, posters and brochures, 
but I still opt for ETjrX because using ETgX ensures consistent formatting, 
and the style of the document can be completely changed by simply using 
a different class file, or loading additional packages. This means that I can 
concentrate on writing the document, rather than worrying about how it will 
look. It also means that if, after having written a 200 page document, I then 
find that I need to change ail the figure captions so that they are labelled 
"Fig" instead of "Figure", ail I need to do is edit a single line, rather than 
going through 200 pages to individually edit every single figure caption. 11 

11 Sure, you could use a search and replace function, but a sweeping replace-all can hâve 
unexpected side effects. For example, your document may include the sentence, "Fig¬ 
ures from the last quarter showed improvement", which would get changed to, "Figs 
from the last quarter showed improvement". 


[FAQ: Why is 
TeX not a 
WYSIWYG 
System?] 
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Serious fiction writers are taught never to remind the reader that they're 
reading a book. Poor formatting is just as much a reminder of this as 
authorial intrusion. 

ETgX makes it very easy to cross-reference chapters, sections, équa¬ 
tions, figures, tables etc, and it also makes it very easy to generate a table 
of contents, list of figures, list of tables, index, glossary 12 and bibliography. 
You don't need to worry about numbering anything, as this is done auto- 
matically, which means that you can insert new sections or swap sections 
around without having to worry about updating ail the section numbering 
etc. Furthermore, if you use BmTgX 15 in combination with ETp;X, and you 
hâve, say, 100 or more citations, it doesn't matter if you are then told that 
the citations hâve to be re-ordered (say, in order of citation rather than al- 
phabetically). Ail that is required is a minor edit to change the appropriate 
style file rather than ploughing through the entire document changing ail 
the citations by hand. 

When you are editing a document using a word processor, the word 
processor has to work out how to reformat the document every time you 
type something. If you hâve a large document with a great many inserted 
objects (such as figures and équations), the response to keyboard input can 
become very slow. You may find that after typing a few words you will hâve 
to wait until the computer catches up before you can see what you hâve 
typed. With ETjX you type in your code using an ordinary text editor. The 
document doesn't get formatted until you pass it to ETgX, which means that 
you are not slowed down by constant reformatting. 

Lastly, there's the fact that ETjtX follows certain typographical rules, so 
you can leave most of the typesetting to ETgX. You rarely need to worry 
about minor things such as inter-sentence spacing. The default is English 
spacing, but if you hâve a publisher who disapproves of this, you can switch 
if off with a single command. (See Section 2.13.) 

ffl^X will also automatically deal with f-ligatures. 1,4 That is, if any of the 
following combination of letters are found: fl, ffl, ff, fi, ffi, they will 
automatically be converted into the corresponding ligatures: fl, fil, ff, fi, ffi. 
Note the différence between fluffier (2 ligatures) and fluffier (no ligatures). 
These points may seem minor but they ail contribute towards the impact of 
the entire document. When writing technical documents, the présentation 
as well as the content is important. Ail too often examiners or referees are 
put off reading a document because it is badly formatted. This provokes 
an immédiate négative reaction and provides little desire to look favourably 
upon your work. 

To give you an idea of what you can do with Ed^X, this book was written 
in ETjrX. 1 - 5 The PDF versions (including the paperback version) were gener- 
ated using PDFETgX and makeindex and the HTML version was generated 


12 Glossaries are covered in Using BTpX to Write a PhD Thesis [13]. 

13 Automating bibliographies is covered in Using ETpX to Write a PhD Thesis [13]. 
ly 'Ligatures can be suppressed using the microtype package if necessary 
15 The source code is available at http://www.dickimaw-books.com/latex/novices/, but it 
really is not the place to start if you are a beginner, as it contains KTpX and Perl code 
beyond the scope of this tutorial. 
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using the RTjQQiHTML 1,6 converter. 

For more reasons as to why you might want to use ETjrX instead of a 
word processor, hâve a look at Why TeX? 


[FAQ: 

Conversion from 
(La)TeX to 
HTML] 


1.1 Class and Package Documentation 

There are hundreds of classes and packages available on the Compréhen¬ 
sive TgX Archive Network 1,7 (CTAN). These are made available by many 
volunteers. Some provide detailed documentation to accompany their con¬ 
tribution, while others only provide a few notes in a README file or com- 
ments in the source files. This book only provides an introductory look at 
a small sélection of these contributions. If you want further details on how 
to use a particular class or package you should check the documentation 
that accompanies it. You can use the texdoc application to search for the 
documentation. This is a command line application, which means you need 
a terminal or command prompt (see Section 2.5). 

To use texdoc, you need to type (at the command prompt) texdoc fol- 
lowed by a space followed by the name of the class or package you want 
information about. For example, to read the memoir documentation, type the 
following at the command prompt (press the return/enter key > at the 
end of the line): 

texdoc memoir 

Some packages corne with more than one set of documentation. For exam¬ 
ple, the glossaries package cornes with the main user manual, a short guide 
for beginners and the documented code for advanced users. Just doing 

texdoc glossaries 

will display the advanced documented code. To list ail available documenta¬ 
tion for a package, use the -1 option: 

texdoc -1 glossaries 

Then type the number corresponding to the file you want to view. If you 
can remember the file name (for example glossaries-user) you can type 
that next time you want to view it: 

texdoc glossaries-user 

There is also a Perl/Tk-based graphical user interface (GUI) called texdoctk, 
which is distributed with TeX Live, that you can use instead of texdoc if you 
can't work out how to use a terminal or prefer a GUI approach. 

Failing that, you can also check on CTAN [1] using the URL ctan.org/ 
pkg/(name), where (name) is the name of the package or class. For exam¬ 
ple, if you want to look up the documentation for the memoir package, you can 


1,6 http : //www. Iatex2html. org/ 
1,7 http : //mirror. ctan. org/ 
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find it at http://ctan.org/pkg/memoir or go to http://mirror.ctan.org/ 
and search for the package or class. 

Another alternative recently made available is to use the URL texdoc. net/ 
pkg/(name). For example, http://texdoc.net/pkg/memoir will fetch the 
documentation for the memoir class. 

However, it's better to use texdoc or texdoctk to read the documentation 
installed with the class or package on your computer to ensure it matches 
the installed class or package version. 

Note that it is important to remember that the TgX world is mostly sup- 
ported by volunteers. CTAN [1] itself is maintained by a very small group 
(currently two people). It's not like a commercial company with 24/7 sup¬ 
port and hundreds of paid employées constantly updating the software. At 
its core, TgX is a community effort. While some volunteers actively maintain 
and update their classes or packages, some people move on to other things 
and stop maintaining their work. Occasionally, if the class or package is 
popular, someone else might take over maintenance. There is no dedicated 
helpdesk to go to, but there are many ways of getting help, see Appendix C 
(Need More Help?) 


1.2 OverView 

This document is structured as follows: 

Chapter 2 (Some Définitions) defines terms that will be used throughout this 
document. I strongly suggest that you look through this chapter before 
you start so that you understand the terminology used in this document. 
At the very least, you should read the first part that details how corre- 
sponding input and output is displayed in this document — you need to 
understand the différence between "input" (source code) and "output" 
(how the source code will appear in the typeset document). 

Chapter 3 (From Source Code to Typeset Output) details the software that you 
will need to use ETgK and describes how to use the software. 

Chapter 4 (Creating a Simple Document) shows you how to create a very basic 
document. 

Chapter 5 (Structuring Your Document) shows you how to create chapters and 
other sectional units so that you end up with a fully structured docu¬ 
ment. 

Chapter 6 (The graphicx Package) shows you how to include external image 
files and how to scale and rotate text. 

Chapter 7 (Floats) describes how to create figures and tables. 

Chapter 8 (Defining Commands) describes how to define your own commands, 
and redefine existing commands. 

Chapter 9 (Mathematics) describes how to typeset mathematics. 
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Chapter 10 (Defining Environments) describes how to define new environments. 

Chapter II (Counters) discusses how numbers are stored in counters, how to 
change their values, and how to define your own counter. 

Appendix A (Downloading and Installing Packages) shows you how to download 
and install additional packages that weren't installed with your TgX dis¬ 
tribution. 

Appendix B (Common Errors) documents possible errors you may encounter, 
and gives advice on how to fix them. 

Appendix C (Need More Help?) gives pointers on where to go for help. 

Throughout this document there are pointers to related topics in the UK 
List of TgX Frequently Asked Questions 18 (UK FAQ). These are displayed 
in the margin in square brackets, as illustrated on the right. You may find 
these resources useful in answering related questions that are not covered 
in this book. 

This book and associated files, including solutions to the exercises, are 
available on-line at: http : //www. dickimaw-books. com/latex/novices/. The 
links in this document are colour-coded: internai links are blue, external 
links are magenta. 


1.3 Recommended Reading 

This document is designed as an introductory text, not a comprehensive 
guide. For further reading try some of the following: 

BTeX: A Document Préparation System [9] is the user guide and ref- 
erence manual for Bl^gX, and is a good basic text for anyone starting out, 
however it doesn't cover AMST^X, so anyone who needs to typeset more 
than basic mathematics may prefer either A Guide to BTeX [7] or The BTeX 
Companion [3]. Both these books cover AMSTgX, BffiTpX and makeindex. 

In the same sériés as The BTeX Companion, there is also The BTeX 
Graphics Companion [5] which details how to illustrate documents with 
UI^X and PostScript, including a chapter on colour (coloured text, back- 
ground, tables and slides). This is recommended to anyone who is contem- 
plating heavy use of graphies, but you do need a basic knowledge of ETgX 
before delving into it. 

The final book in the "Companion" sériés which you may find useful is 
The BT^X Web Companion [4]. This is recommended for those interested 
in creating documents for the web, either as HTML or PDF. It details how 
to convert ETgX documents into HTML using various applications such as 
LaTeX2HTML and TeX4ht, and how to create PDF documents using PDFETgX, 
including how to create active links within your document using the hyperref 
package. 

There are two new ETgX books that I haven't read but hâve been rec¬ 
ommended to me: BTeX Beginner's Guide [8] and BTeX and Friends [19]. 

1 - 8 http : //www. tex. ac. uk/faq 


[FAQ: What is 
LaTeX?] 


[FAQ: Books on 
LaTeX] 

[FAQ: What are 
the AMS 
packages?] 


[FAQ: What is 
PDFTeX?] 
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Note that the UK TgX User Group 19 (UK TUG) has a 25% book discount 
scheme for members. See http : //uk. tug. org/membership for more details 
of that and other associated benefits. If you're not in the UK, hâve a look at 
http://www.tug.org/usergroups.html to see if there is a local user group 
in your area. 

There is also a wealth of UTj;X-related information on the Internet. [FAQ: How to get 
CTAN [1] is a good place to start. You can check the on-line catalogue [21] help] 
for information about available software and, as mentioned earlier, there is 
also the list of frequently asked questions which I recommend you try if 
you hâve any queries. See also Appendix C (Need More Help?) 


1.9 


'http://uk.tug.org/ 



Chapter 2 

Some Définitions 


As mentioned in Chapter 1 (Introduction), ETgX is a language, so you can't 
simply start typing and expect to see your document appear before your 
very eyes. You need to know a few things before you can get started, so it's 
best to define a few terms first. Don't worry if there seems a lot to take in, 
there will be some practical examples later, which should hopefully make 
things a little clearer. 

Throughout this book, source code is illustrated in a typewriter font with 
the word input placed in the margin, and the corresponding output (how it will 
appear in the PDF document) is typeset with the word Output in the margin. 

Example: 

A single line of code is displayed like this: 

This is an \textbf{example} . 

The corresponding output is illustrated like this: 

This is an example. 

Segments of code that are longer than one line are bounded above and 
below, illustrated as follows: 


Line one\par 
Line two\par 
Line three. 


with corresponding output: 


Line one 
Line two 
Line three. 


Take care not to confuse a backslash \ with a forward slash / as they hâve 
different meanings. (Commands typeset in blue, such as \par, indicate a 
hyperlink to the command définition in the summary.) 

Command définitions are shown in a typewriter font in the form: 

\documentclass [(options)] {( class file)} 

In this case the command being defined is called \documentclass and text 
typed (like this ) (such as ( options) and (class file)) indicates the type of thing 


[FAQ: Why is 
TeX not a 
WYSIWYG 
System?] 


Input 


Output 


t Input 


| Input 


t Output 


X Output 


Définition 
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you need to substitute. (Don't type the angle brackets!) For example, if you 
want the scrartcl class file you would substitute (class file) with scrartcl 
and if you want the letterpaper option you would substitute ( options } with 
letterpaper, like this: 

\documentclass [letterpaper]{scrartcl} 

But more on that later. 

Sometimes it can be easy to miss a space character when you're reading 
this kind of book. When it's important to indicate a space, the visible space 
Symbol is used. For example: 

A^sentence^consisting^of^six^words. 

When you type up the code, replace any occurrence of with a space. 

One other thing to mention is the comment character % (the percent 
Symbol). Anything from the percent Symbol up to, and including, the end 
of line character is ignored by ET^X. Thus 


A simple % next cornes a command to make some bold text 
\textbf{ example} 

i_i 

will produce the output 
A simple example 

The percent symbol is often used to suppress unwanted space resulting from 
line breaks 21 in the source code. For example, the following code 

Foo% 

Bar 


will produce the output: 

FooBar 

as opposed to 

Foo 

Bar 


which will produce the output: 

Foo Bar 

On the other hand, spaces at the start of a line of input are ignored, so 


Foo% 

Bar 


still produces: 

FooBar 

9 - 1 KT[-/v treats the end-of-line character as a space. 


Input 

Input 

î Input 
4. Input 

Output 

î Input 
4, Input 

Output 

■f Input 
4- Input 

Output 

■f Input 
4- Input 

Output 











Chapter 2 Some Définitions 


9 


2.1 Source Code 

The source code consists of ali the text and EŒ^X commands that make up 
an entire document. The source code is typed in using a text editor, and 
saved with the file extension .tex. The source code may be contained in 
just one file, or it might be split across several files. 


2.2 Output File 

The ETgX application reads in your source code and créâtes the typeset doc¬ 
ument, the output file. This book assumes that you will be using the version 
of ET E X that produces PDF files (PDFETgX). If you are using TeXWorks (see 
Chapter 3 (From Source Code to Typeset Output)), you need to select the 
"PDFLaTeX" item from the drop-down list. If you are using TeXnicCen- 
ter, select the "LaTeX=i>PDF" build profile. If you are using WinEdt, when 
you want to build your document click on the button marked "PDFLaTeX" 
rather than the one marked "LaTeX". If you are using a terminal or com- 
mand prompt, use the command pdflatex rather than latex. (TeXnic- 
Center, WinEdt and using the terminal or command prompt approach are 
described in the supplémentai material.) 2,2 


2.3 DVI File 

TgX (and subsequently ETgX) originally created DVI (DeVice Independent) 
files instead of PDF files. 2,3 Elowever, although there are free DVI viewers, 
not many people hâve them installed, so it's really only T E X users who can 
read them. Also, you can't embed image files in a DVI file or hâve fancy 
effects, such as rotation. Instead, people can use T^X/Ed^X to create a DVI 
file and then use an application to convert the DVI file to PostScript. 

These days PDF is the preferred platform-independent format, and with 
the advent of PDFT E X, modem T E X/ET E X users can directly create PDF 
documents rather than going through the DVI route. Some people still 
prefer to create DVI files as an intermediate step, particularly if they want 
to embed PostScript instructions (as is done by the pstricks package). For 
simplicity, this book assumes that you hâve a modem T E X distribution and 
are using PDFETjX rather than ET E X=^DVI. 


2.4 Auxiliary Files 

When ET E X créâtes your output file, it not only créâtes a PDF file but also 
créâtes other associated files. The most common of these are the log file, 
which has the extension . log, and the auxiliary file, which has the extension 
. aux. 


[FAQ: 

TeX-friendly 
editors and 
shells] 


2,2 http://www.dickimaw-books.com/latex/novices/html/supplemental.html 
2,3 There was no PDF back then. 
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The log file contains a transcript of the most recent ETgX run. It lists 
ail the files that hâve been loaded, including the class file and any packages 
that your document has used. There should also be the class or package 
version number and date, although this is dépendent on the class or package 
author. If you ever want to ask for help, you need to say what version you 
are using. 

For example, this book uses the scrbook class, so the log file includes the 
lines: 

(/usr/local/texlive/2010/texmf-dist/tex/latex/koma-script/ 
scrbook.cls 

Document Class: scrbook 2010/06/17 v3.06 KOMA-Script document 
class (book) 

(This is actually now out-of-date as the latest version at the time of writing 
this is version 3.11a dated 2012/07/05.) 

Error messages, warnings and general information messages are also 
written to the log file as well as the document statistics. You can delete this 
log file if you like. It will be created again the next time you run ETgX. 

The auxiliary file contains ail the information needed for cross-referencing 
(covered in Section 5.5). This is needed to ensure ail your cross-references 
are up-to-date. You can delete this file, but you will need at least two ETgX 
runs to ensure your cross-references are correct the next time you create 
your output file. 

TeXWorks also créâtes a file with the extension .synctex.gz. This file 
allows you to jump to and from the source code and the appropriate part of 
the output file. If you delete this file, you will hâve to run ETgX again before 
you can use this function. 

Other files that may be created include the table of contents file (. toc), 
the list of figures file (. lof) and the list of tables file (. lot). Some class 
files or packages create additional files. If your operating System hides file 
extensions, you might want to switch off this behaviour, if possible, to make 
it easier to distinguish between ail the various files. 

TeXWorks has a menu item File—>Remove AUX Files that will remove the 
auxiliary files. 


2.5 Terminal or Command Prompt 

Sometimes you may find that you need to use a command-line application. 
This is an application that doesn't hâve a graphical user interface. This isn't 
spécifie to TgX, but the TgX distribution cornes with a number of them. In 
fact, front-ends (such as TeXWorks) run some of these applications for you 
when click on the typeset or build button. 

Most operating Systems provide a terminal or command prompt where 
you can type the command-line application name and any associated infor¬ 
mation. For example, Figure 2.1 shows a terminal running under Fedora 
on Linux. 
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Windows To open the MSDOS Prompt, go to the Start menu, then "AU Pro- 
grams", then "Accessories" and click on "MSDOS Prompt". 

Mac OSX To open the Mac Terminal, go to your "Applications" folder, open 
"Utilities" and double click on "Terminal". 

Unix etc The Terminal is usually located either in the "Applications" menu 
or in the "System Tools" subdirectory of the "Applications" menu. 



Figure 2.1 A Terminal 


Example: 

One such command-line application you are likely to need is texdoc. This 
is mentioned in more detail in Section 1.1, but to use texdoc you need to 
open the terminal or command prompt as described above and type texdoc 
followed by a package or class name, for example: 

texdoc scrbook 

(see Figure 2.2) then press the Enter or Return key. 

Other TgX-related command-line applications include pdflatex, bibtex, 
makeindex, xindy and kpsewhich. 


2.6 Commands 

A command is used to tell ETgX to do a particular thing at that point in the 
document. These are the basic forms a command can take: 
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Figure 2.2 Running texdoc From a Terminal 


1. A Control Word. 

This is a backslash \ followed by letters (A,...,Z,a,...,z). There can be 
no non-alphabetical characters in the command, apart from the ini¬ 
tial backslash, and the name is always case-sensitive so, for example, 
\gairana and \Gamma hâve different meanings. One command that often 
trips up new users is \LaTeX, which prints the LaTeX logo: ETp;X. This 
command has three captial letters and two lower case letters. If you 
get the case of any of the letters incorrect, you will get an "undefined 
control sequence" error. 

There must be no space between the backslash and the start of the 
command name. Some command names are made up of two or more 
names joined together, such as \tableofcontents. Make sure you 
don't insert any spaces in the control word. This will either lead to 
an error or an unexpected resuit. For example, 

\appendixname 

displays "Appendix" but 

\appendix name 

switches to the appendices and then prints the word "name". 

Most ETp;X commands hâve fairly self-explanatory names. (For exam¬ 
ple, \chapter starts a new chapter and \rightarrow prints an arrow 


[FAQ: 

Commands 
gobble following 
space] 
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pointing to the right.) However, in most cases, you need to use U.S. 
spelling (for example, \color rather than \colour). 

This is the most common form of command. Any spaces immediately 


following a command of this type are ignored, so for example 

\TeX nician Input 

will produce 

TpXnician Output 

whereas 

\TeX{} nician Input 

will produce 

nician Output 

But the following will cause an "undefined control sequence" error: 

\TeXnician )C 


There is one command that you must use in every document you cre- 
ate, and that is the \documentclass command. This command must be 
placed at the very start of your document, and indicates what type of 
document you are creating. This command is described in more detail 
in Chapter 4 (Creating a Simple Document). 

2. A Starred Command 

Some commands hâve variants that are indicated by an asterisk at the 
end of the name. For example, \chapter makes a numbered chap¬ 
ter whereas \chapter* is makes an unnumbered chapter. A starred 
command is the version of the command with the asterisk. (On a UK 
keyboard the asterisk character is usually located on the same key as 
the digit 8.) 

This may seem like a different form to a control word, described above. 
After ail, I've just said that a control word can only contain alphabetical 
characters. However a starred command is actually a control word 
(such as \chapter) followed by an asterisk. The control word checks 
to see if the next character is an asterisk. If it is, it performs one action, 
otherwise it performs another action. 

This type should therefore just corne under the previous category, but 
as you will often hear of "starred commands" it seemed better to hâve 
a separate category. 

3. A Control Symbol. 

This is a backslash followed by a single non-alphabetical character. For 
example \% will print a percent Symbol. Spaces are not ignored after 
this type of command, for example 
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17.5 \% VAT 
will produce 
17.5% VAT 

It's also possible to hâve starred forms of control symbols. For example 
\\ forces a line break. If it's not followed by an asterisk a page break 
is allowed at that line break, but if it is followed by an asterisk \\* no 
page break is allowed at that line break. (If a page break is needed, it 
will be made at the end of the previous line instead.) 

4. Character Sequence. 

Some spécial sequences of characters combine to form an instruction. 
For example ffi is the command to produce the ffi ligature, and the 
sequence of symbols ! ‘ is the command to produce the upside down 
exclamation mark j 

5. An Internai Command. 

This is like the first type, a control word, but the @ character ap- 
pears in the command name (for example \c@section) however in¬ 
ternai commands should only be used in class files or packages. The 
@ symbol takes on a spécial meaning when a file is included using 
\documentclass (a class file) or \usepackage (a package). 

For example, in a class file or package \c@section is an internai rep¬ 
résentation of the section counter, whereas in a . tex file \c@section is 
interpreted as the command \c (the cedilla accent command) that takes 
the character @ as its argument, followed by section, which produces 
the rather odd looking @section. 

Don't be tempted to use internai commands until you hâve first grasped 
the basics. You hâve been warned! 


2.7 Grouping (or Scope) 

A segment of code may be grouped by placing it within { and } (curly 
braces). Most commands that occur within a group will be local to that 
group. For example, \bfseries changes the font weight to bold, so the 
following segment of code: 

I I 

Here is some text. {This text \bfseries is in a group.} Here is 
some more text. 

i_i 

will appear in the typeset document looking like: 

Here is some text. This text is in a group. Here is some more text. 

As can be seen, the font change only stays in effect until it reaches the 
end of the group (signified by the closing curly brace }.) For a command to 
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Output 
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be in the same scope as another command, both commands must be within 
the same group. For example, in the following, \bfseries and \itshape 
are in the same scope: 

{\bfseries Some bold \itshape and italic text} 

But below, they are in different scopes: 

{\bfseries Some bold text} {\itshape and some italic text} 
Environments form an implicit scope. 

2.8 Arguments (also calïed "Parameters") 

Some commands take one or more arguments. This provides a way to 
give ETgX additional information so that it is able to carry out the command. 
There are two types of arguments: mandatory and optional. 

2.8.1 Mandatory Arguments 

Mandatory (or compulsory) arguments are arguments that hâve to be spec- 
ified. 

Examples: 

1. If you want a footnote, you need to use the \footnote command, which 
has a mandatory argument that spécifiés the contents of the footnote. 
Like this: 

Here is a footnote. \footnote{This is the footnote 
text. } 

Elere is a footnote. 24 

(By default you won't get a hyperlink. This book uses the hyperref pack¬ 
age, which generates the hyperlinks.) 

2. If you want to start a new chapter, you need to use the \chapter com¬ 
mand, but you also need to tell ETgX the title of this new chapter. So 
the \chapter command takes one mandatory argument that spécifiés 
the title. 

For example, the following code: 

\chapter{Some Définitions} 

was used to generate the heading for the current chapter (at the top 
of page 7). 

3. The command \textbf typesets its argument in a bold font (as opposed 
to the déclaration \bfseries which switches to a bold font.) 

For example, the following code: 
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\textbf{Some bold text.} 
produces the output 

Some bold text. 

Notes: 

1. ETgX takes the first non-space object following the command name as 
the argument, which is why in the above examples the arguments hâve 
to be grouped. 

Suppose the last example above didn't hâve a group, so instead the 
code was: 

\textbf Some bold text. 

then only the "S" would be the argument because it's the first object 
following the command, in which case the output would look like: 

Some bold text. 

2. If you want the argument to be blank, use empty braces: {}. For 
example, suppose you want to hâve a chapter without a title 25 you 
would need to do: 

\chapter{} 


2.8.2 Optional Arguments 

Some commands may hâve one or more optional arguments. Unlike 
mandatory arguments, optional arguments must always be enclosed in square 
brackets [ ]. 

Example: 

The command \\ ends a line. So the following segment of code: 

Line one\\Line two. 

will produce the following output: 


Line one 
Line two. 


However the \\ command also has an optional argument that allows you to 
specify how big the gap between the two lines should be. So the following 
segment of code: 

Line one\\[ lcm]Line two. 
will produce the following output: 


24 This is the footnote text. 

25 The numbers for chapters, sections etc are automatically inserted by KTpX, so this ex¬ 
ample would produce a numbered chapter without a title. 
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Line one 


Line two. 


Incidentally, note the différence between the previous example, and the 
following example: 

Line one\\{[lcm]} Line two. 


Line one 
[lcm] Line two. 


In this example the [lcm] has been placed inside a group, so it is no longer 
considered to be an optional argument, and since the command \\ does 
not take a mandatory argument, the [lcm] is simply interpreted as ordinary 
text. 

Example: 

The command \framebox (which will be covered later in Section 4.7.1) takes 
a mandatory argument and two optional arguments, \framebox puts a frame 
around the contents of its mandatory argument: 

\framebox{Some Text} 

Some Text 

The first optional argument can be used to make the box a specified width: 
\framebox [4cm] {Some Text} 

Some Text 

The second optional argument spécifiés the justification of the text (left, 
right or centred) within the box: 

\framebox [4cm][r] {Some Text} 

_ Some Text 

In general, if a command has both optional and mandatory arguments, 
the optional arguments are usually specified first (although there are a few 
exceptions). 


2.9 Moving Arguments and Fragile Commands 

Certain types of commands, called fragile commands, can seriously mess 
things up when they are used in what is termed a moving argument These 
types of argument are generally those whose contents are copied to another 
part of the document. For example, section headings appear at the start of 
a section, but they can also appear in the table of contents. The \footnote 
command is a fragile command, so 
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\section{A heading\footnote{with a footnote}} )C 

will cause an error. 

If there is no other command to use in its place, you should use \protect 
immediately before the fragile command: 

\section{A heading\protect\footnote{with a footnote}} 

This, however, is a contrived example, because it isn't a good idea to hâve a 
footnote in a section heading, as it will also end up in the table of contents, 
and possibly in page headings. 

2.10 Robust Commands 

A robust command is a command that is not a fragile command. 

2.11 Short and Long Commands 

A short command is a command whose argument may not contain a para- 
graph break (either as a blank line or using \par.) Conversely, a long 
command is a command whose argument may contain a paragraph break. 

Using short commands helps to test for forgotten braces, so it is rec- 
ommended that when you define a new command (see Chapter 8 (Defining 
Commands)) you should always make the command a short command, un- 
less there is a chance that the argument may need to contain a paragraph 
break. 

2.12 Déclarations 

The term déclaration is used to refer to a command that affects the docu¬ 
ment from that point onwards. The déclaration itself does not produce any 
text and, in most cases, its effect can be localised by placing the déclaration 
within a group. For example, \bfseries is a déclaration that switches the 
current font weight to bold, so the following code 


Here is some normal text. 
\bfseries Here is some bold text. 


will appear in the typeset document looking like: 

Here is some normal text. Here is some bold text. 

Some déclarations don't immediately hâve a visible effect. For example, 
the déclarations 
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only set the paragraph justification to ragged-right, ragged-left or centred, 
respectively, if the déclaration is still in effect at the end of the paragraph. 
That is, if it is still in effect at the next \par or blank line. 

Example: 

i i 

This is an example paragraph illustrating the paragraph 

justification déclarations. The default justification is fully 
justified. \raggedright The paragraph justification can be 
switched to ragged-right or \raggedleft ragged-left. \par 


This is an example paragraph illustrating the paragraph justification 
déclarations. The default justification is fully justified. The paragraph 
justification can be switched to ragged-right or ragged-left. 


Above, the justification at the paragraph break is ragged-left, so that's the 
justification used for the entire paragraph. Compare with: 


{This is an example paragraph illustrating the paragraph 
justification déclarations. The default justification is fully 
justified. \raggedright The paragraph justification can be 
switched to ragged-right or \raggedleft ragged-left.} \par 


This is an example paragraph illustrating the paragraph justification déc¬ 
larations. The default justification is fully justified. The paragraph justifica¬ 
tion can be switched to ragged-right or ragged-left. 


Above, the justification at the paragraph break is fully-justified, since both 
the déclarations \raggedright and \raggedleft are cancelled when their 
local scope (signified by the curly braces) ends. This type of mistake most 
often occurs when people try to centre text doing something like: 

{\centering Some text that is supposed to 
be centred. 

} 

Next paragraph. 

The paragraph break (blank line) must go before the closing brace. 

{\centering Some text that is supposed to 
be centred. 

} 

Next paragraph. 

While we're on the subject of centred text, don't be tempted to use 
\centerline. It's obsolète [15]. 
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2.13 Inter-Sentence Spacing 

Inter-sentence spacing refers to the default type of space to be inserted 
between adjacent sentences within a paragraph. There is disagreement 
over what size this space should be. French spacing uses the same space as 
used between words. English spacing uses an en-space (half an em-space). 
With proportional fonts (such as this one), the en-space is slightly larger 
than a single space. The différence is shown here: 


X X 

X\enspace X 


X X 
X X 


(Note that with fully-justified paragraphe in both cases the spaces may be 
stretched to ensure the sides of the paragraph are flushed.) 

TgX (and ffljX) defaults to English spacing, but you can switch to French 
spacing using the déclaration: 

\frenchspacing 

and switch back again using 

\nonfrenchspacing 

There was no en-space on a typewriter, so typists started using two spaces 
in an attempt to emulate that slightly larger than one space look. This 
habit has spread to word-processor users as well, and now many people 
incorrectly assume English spacing means adding two spaces after a full 
stop, which is too wide and looks ugly, but this error shouldn't be used as a 
criticism against English spacing. 

There has been a graduai trend towards French spacing over the last 
century, and some publishers insist on it. I think this may in part be due 
to a backlash against the ugliness of two spaces in typewritten and word- 
processed documents. In fact the Oxford Style Manual [11] simply States, 
"In text, only use a single space after ail sentence punctuation." 

Personally, I prefer English spacing, particularly in reference books. 
I hâve many reference books on my shelf, but I haven't read any of them 
from cover-to-cover. I flick to a particular section and skim through the 
paragraphs until I reach the desired bit of information. Sometimes I've 
already looked something up, so I hâve a vague idea as to where to find the 
information. The extra space between sentences makes it easier to locate a 
particular sentence. 

This isn't so much of an issue with books designed to be read from 
beginning to end, such as a novel. However, I hâve read one such book 
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that used a font where the commas had tiny tails and most of the sentences 
contained multiple proper nouns, which made it very difficult to read as it 
wasn't clear where the sentences ended. Is that a full stop followed by a 
new sentence that happens to start with a proper noun, or is it a comma 
whose tiny tail is blurred by my short-sighted eyes followed by a clause 
that happens to start with a proper noun? A well-written, well-presented 
document should not interrupt the reader, forcing them to continually go 
back to re-parse a sentence. 

However, if you are writing a document, whether prose or technical, 
with the intention of having it published you must check with the publisher's 
guidelines to see if they insist on a particular style. 

Notes: 

An end of sentence punctuation mark can be one of: a full stop (. ), excla¬ 
mation mark (!) or question mark (?). 

1. If an end of sentence punctuation mark follows a lower case character, 

TgK assumes the punctuation mark indicates the end of the sentence. 

For example, as in: 

Did you see that? I certainly did. 

2. Where this isn't the case, use (backslash followed by a space). 


This can happen when a sentence contains a lower case 
abbreviation, e.g.\,_,like this one. 


3. If an end of sentence punctuation mark follows an upper case charac¬ 
ter, TgX assumes the sentence hasn't ended at that point. For example, 
as in: 

The G.P. said it was only hypochondria. 

4. Where the sentence actually ends with an upper case letter, add \@ 
after the letter and before the punctuation mark. 


i i 

Yesterday, I saw my G.P\@. Tomorrow I’m going to see the 
specialist. 


Note on Typewriter Fonts 

Note that \nonfrenchspacing in a monospaced font will insert two spaces 
between sentences, emulating a typewritten document. 
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\ttfamily 

\nonfrenchspacing x. x. 
\frenchspacing x. x. 


x. x. 
x. x. 


2.14 Hyphenation 

Words sometimes require hyphenation to help justify paragraphs and pre- 
vent overly large areas of white space or protrusions into the right margin. 
Some word processors by default don't hyphenate words in fully-justified 
paragraphs, which has led some people to believe that hyphenation is bad. 
Just because word processors do something a certain way, doesn't mean that 
it's the correct way. TgX has an excellent hyphenation algorithm, but the 
default hyphenation pattern is designed for English. If you are writing in 
another language, use the babel package to switch the hyphenation pattern 
(see Section 5.8). 

Despite using an excellent algorithm, occasionally gets the hyphen¬ 
ation wrong, particularly where the hyphenation is context sensitive. There 
are two ways of setting the hyphenation for a given word. 

1. For ail occurrences of the word, use 
\hyphenation {(hyphenated word}} 

inserting a hyphen - at ail possible hyphenation points. For example: 
\hyphenation{gal-axy} 

2. For a particular instance of a word, use \- at the hyphenation point 
within the word. For example: 


i i 

There once was a little alien called Uiop who lived in the 
faraway gal\-axy of Zxcv. 
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2.15 Environments 

An environment is a block of code contained within the commands 

\b e g i n { ( env-name ) } 

and 

\ e nd { ( env-name} } 

where ( env-name } is the name of the environment. The block of code is 
then formatted in a method spécifie to that environment. For example, the 
bfseries 2 - 6 environment will typeset the contents of the environment in a bold 
font. The following code: 

\begin{bfseries}Here is some bold text. \end{bfseries} 
will appear in the typeset document looking like: 

Here is some bold text. 

Some environments also supply commands that may only be used within 
that environment. 

Example: 

The itemize environment provides a command called \item so that you can 
specify individual items within an unordered list: 


Shopping List: 
\begin{ itemize} 
\item Cabbages 
\item Bananas 
\item Apples 
\end{itemize} 


The above will produce the following output: 

I 

Shopping List: 

• Cabbages 

• Bananas 

• Apples 


2 6 Note there is no backslash in the environment name. 
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2.16 The Preamble 

The preamble is the part of the source code that cornes after the 
\documentclass command and before \begin{document} (the start of the 
document environment). Only a few spécial commands may be placed in the 
preamble (such as \title), and there are a few spécial commands that may 
only go in the preamble (such as \usepackage). Nothing that generates text 
(for example, \maketitle) may go in the preamble. 

\documentclass{ ... } 

<— This bit in here is the preamble. 

\begin{document} 


2.17 Lengths 

A length register stores dimensions (such as lin, 5cm, 8.25mm). Like con- 
trol words, length registers start with a backslash and only contain alpha- 
betical characters in their name. These registers are used to détermine 
page layouts etc. For example, the paragraph indentation is given by the 
length register \parindent. Acceptable units of measurement are listed in 
Table 2.1. The two relative units "em" and "ex" are dépendent on the current 
font. (The em-value used to be the width of an "M" and the ex-value was 
the height of the letter "x", but these days the values are more arbitrary [6].) 
Use em for widths and ex for heights if you want to use relative values. 

Table 2.1 Units of Measurement 

pt TgX point: 72.27pt = lin 

in inch: lin = 25.4mm 

mm millimétré: lmm=2.845pt 

cm centimètre: 1cm = 10mm 

ex the "x-height" of the current font 

em the width of a "quad" in the current font 

sp scaled point: Isp = 65536pt 

bp big point (or PostScript point): 72bp = lin 

dd didôt point: ldd=0.376mm 

pc pica: lpc = 12pt 

cc cicero: lcc=12dd 

mu math unit: 18mu = lem 

To change a length you can use the command: 

\setlength {(cmd)} {(length)} 

where (cmd) is the register (for example, \parindent) and ( length ) is the 
new length. Alternatively, you can add a value to a length using: 

\addtolength {(cmd)}{(length incrément)} 

The value of a length register can be displayed in your document using 


Définition 


Définition 



Chapter 2 Some Définitions 


25 


\th e(register) 

A rubber length is a length that has a certain amount of elasticity. This 
enables you to specify your desired length but allows ETgX to stretch or 
contract the space to get the body of text as flushed with the margins as 
possible. 

For example, the paragraph gap \parskip is usually set to 0pt plus lpt. 
This means that the preferred gap is Opt but ETgX can stretch it up to lpt 
to help prevent the page from having a ragged bottom. For example: 


\setlength{\parindent} {0pt} 

\setlength{\parskip}{10pt plus lpt minus lpt} 

This is the first paragraph. 

This is the second paragraph. 

The paragraph indentation is \the\parindent . 


This now produces: 


This is the first paragraph. 

This is the second paragraph. The paragraph indentation is O.Opt. 


In this example, the preferred paragraph gap is lOpt but it will allow for a 
déviation of up to plus or minus lpt. 

Note that it's generally best not to change \parskip explicitly as it can 
cause unexpected complications. If you use one of the KOMA-Script classes, 
such as scrreprt, you can use the parskip class option that can take the 
following values: parskip=full (a full line height) parskip=half (half a line 
height). 2 * ' 7 

Example: 

\documentclass [parskip=full]{scrbook} 

If you want to change any of the page layout lengths (such as \textwidth), 
the easiest way to do it is to use the geometry package. This package should 
hâve been installed when you installed your TgX distribution. For example: 
suppose you want the total text area to be 6.5in wide and 8.75in high with a 
left margin of 0.4in, then you would do: 

\usepackage [body={6.5in,8.75in},left=0.4in]{geometry} 


2 7 There are also variants that hâve +, - or * as a suffix. See the KOMA-Script documentation 

for further details. 
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2.18 Class File 

The class file (.cls) defines the page layout, heading styles and various 
commands and environments needed for a particular type of document. 
The class file is specified using the command 

\documentclass [(options)] {( class-name }} 

where ( class-name } is the name of the file without the .cls extension. Ail 
documents must start with this command. This book uses the scrbook 

class. 


2.19 TeX 

TpX is the typesetting language written by Donald Knuth. He wrote a format 
of TgX called Plain TgK, but many people find Plain TgX complicated, so 
Leslie Lamport wrote a format of called ETgX to make it a bit easier to 
use. You can think of ETgX as a go-between converting your instructions 
into TgX. This book mostly uses the term ETgX, even if the matter is more 
general to TgX, to avoid complicating matters. Some error messages you 
may see will be ETjrX messages, some will be TgX messages. ETgX error 
messages tend to be a bit easier to understand than TgX messages. There 
are other formats of T^X, such as ConTeXt, but this book does not cover 
them. 


2.20 Perl 

TgX-distributions such as TeX Live and MiKTeX also include some helper 
applications that you may find useful. For example, texdoc (Section 1.1) 
helps you access installed documentation and make index helps generate an 
index for your document. Some of the helper applications are written in 
a scripting language called Perl, and you must hâve the péri application 
installed to be able to use them. Unix-like operating Systems should already 
hâve it installed. Windows users can choose between several Perl distri¬ 
butions. The most popular seem to be Strawberry Perl and Active Perl. 
Perl scripts that corne with T^X include: epstopdf (converts Encapsulated 
PostScript (EPS) files to PDF), pdfcrop (crops a PDF file), xindy (a more 
flexible indexing application than makeindex), texcount (counts the number 
of words in a ETjrX document) and latexmk (runs DT^X and any associated 
applications, such as bibtex, the required number of times to ensure the 
document is fully up-to-date). 
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Every time you want to create or edit a ETgX document, there are three 
basic steps you will always need to follow: 

1. Write or edit the source code. 

2. Pass the source code to the latex or pdflatex application ("ETp;X the 
document"). 

• If there are any error messages, return to Step 1. 

• If there are no error messages, a PDF file is created. 

3. View the PDF file to check the resuit. If you need to modify your 
document, go back to Step 1. 

You will therefore need: 

F A text editor (to perform Step 1). For example Vim, Emacs or Gedit. 

2. The TgX software (to perform Step 2). If you don't already hâve TgX 
on your machine, you will need to install it. The most convenient way 
to do this is to install from the TgX Collection DVD ROM, which is 
distributed to ail T^X User Group 31 (TUG) members, but you can also 
download and install free TgX distributions, such as TeX Live, MiKTeX 
or MacTeX, from the Internet (see on the following page). There is also 
proTeXt, an enhancement of MiKTeX that aims to be an easy-to-install 
TgX Distribution. For more information including up-to-date links, go 
to http://www.ctan.org/starter.html. 

3. A PDF viewer (to perform Step 3). For example Adobe Reader, Sumatra, 
Evince or Okular. 

This can be rather complicated for a beginner, especially for those with 
no expérience writing computer code. Fortunately, there are some all-in- 
one applications (often called a front-end) that provide a text editor (for 
Step 1), buttons or menu items to run the latex or pdflatex command-line 
application (for Step 2) and, in some cases, a viewer to perform Step 3. 


3 - 1 http : / / tug. org/ 
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Section 3.1 describes one such front-end called TeXWorks. I hâve chosen 
to describe TeXWorks because it is a free, cross-platform application. Bina- 
ries are available for Microsoft Windows, Mac OS X and GNU/Linux. The 
screen shots of TeXWorks in this book were taken from the Linux version 
running under Fedora. If you run TeXWorks on other operating Systems, 
it may hâve a slightly different look, but it has the same functionality. 

New versions of TeX Live and MiKTeX include TeXWorks for MS Win¬ 
dows, and new versions of MacTeX include TeXWorks for Mac OS X users. 
GNU/Linux users can use their Add/Remove Software utility to install TeX¬ 
Works. Alternatively, you can download TeXWorks by following the links 
provided at http://www.tug.org/texworks/. 

If you're confused by ail the options, let's keep things as simple as pos¬ 
sible: 

• MS Windows: 

You hâve a choice between MiKTeX (or proTeXt) and TeX Live. MiKTeX 
provides a smaller and quicker installation, but the downside is that 
you may not hâve the classes or packages you want to use. MiKTeX can 
install these whenever you try to ETgX a document that uses them, but 
you need an Internet connection while it does this. TeX Live installs 
everything, so it takes longer and needs more space, but you should 
hâve the majority of packages and classes that you need. 

TeX Live: 

1. Fetch and unpack http : //mirror. ctan. org/systems/ 
texlive/tlnet/install-tl.zip 

2. Run install-tl and follow the instructions. This 
can take an hour or more. 

proTeXt: 

1. Go to http://tug.org/protext/ 

2. Click on the "download the self-extract protext.exe" 
link to download and run the exécutable. 

MiKTeX: 

1. Go to http://www.miktex.org/ 

2. In the left-hand panel, there is a link to the down¬ 
load page for the latest version. At time of writing, 
it is MiKTeX 2.9. Click on that link. 

3. Scroll down to the section "Installing a basic MiKTeX 
System". 

4. If you're happy with the selected mirror location, 
click on the "Download" button. 

5. Run the exécutable. 

• Mac OS X: 


1. Goto http://tug.org/mactex/ 
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2. Follow the instructions on that page. 

• GNU/Linux: 

1. Fetch and unpack http://mirror.ctan.org/systems/ 
texlive/tlnet/install-tl-unx.tar.gz 

2. Follow the instructions at http : //tug. org/texlive/quickinstall. 
html 

3. Once TeX Live has finished installing, run your sys- 
tem's "Add/Remove Software" tool. 

4. Find "texworks", select the newest version and install. 

If you run into problems, there are mailing lists at http://tug.org/ 
mailman/listinfo/tex-live and http : //docs .miktex. org/manual/lists. 
html for TeX Live and MiKTeX, and MacTeX help at http://www.tug.org/ 
mactex/help/. There is also a list of places where you can ask for help in 
Appendix C (Need More Help?). 


3.1 TeXWorks 

Hopefully you've managed to successfully install TgX and TeXWorks as de- 
scribed above, so let's test it out. 

First run TeXWorks. On Windows, you can access it via the Start menu. 
On GNU/Linux, it's probably located in Applications—^Office, or you can type 
texworks in a terminal. You should now see the TeXWorks window. The 
button marked with a grey triangle in a green circle is the build or typeset 
function. It runs the application in the drop-down list next to it. This is set 
to pdfLaTeX, which is what we want for now. 

It's a good idea to switch on the syntax highlighting, if it isn't already on. 
This is done via the Format—*Syntax Coloring sub-menu. Make sure the LaTeX 
item is selected. 

Next, type in the following sample source code, as shown in Figure 3.1 
(the commands used here will be described in more detail in Chapter 4 
(Creating a Simple Document)): 


1 1 t Input 

\documentclass{scrartcl} 

\begin{document} 

This is an example document. 

\end{document} 

i 1 Input 


Pay close attention to the backslashes at the start of each command 
name. If you find the font is a bit too small for you, you can make it larger 
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using the Format—>Font menu item. This doesn't affect the font size in your 
PDF file, just the font size of your code. This displays the "Select Font" 
dialog box. Set the font size as appropriate. 

Then save the document, using the File—>Save As menu item. I called 
my document example 1. tex (remember the . tex extension and stick to file 
names that only consist of alphabetical characters, digits and hyphens — 
don't uses spaces or underscores). 

Now that you hâve saved the file, you can run pdfLaTeX. Make sure the 
drop-down list next to the build button has "pdfLaTeX" selected and click on 
the build button. If ail goes well, a new window should open displaying the 
typeset document (Figure 3.2). 

Now let's see what happens if there is an error in the source code. In 
Figure 3.3 I hâve misspelt the \documentclass command. This time, when 
I click on the build button, I get the error message: 

! Undefined control sequence. 

1.1 \documentclas 

{scrartcl} 

? 

(Shown in Figure 3.4.) 

Here "Undefined control sequence" means an unrecognised command, 
and below that message, "1.1" means the error was encountered on line 1. 
An input line at the bottom of the window has appeared with a cursor. 
ETgX is in interactive mode and is awaiting a response. There are several 
responses, but I'm only going to mention two of them: 

1. Type h and press the Return/Enter key '. This displays a short help 
message and awaits a new response (see Figure 3.5). 

2. Type x and press Return/Enter. This aborts the ETjrX run. 

Notice that the green circle button with the grey triangle has turned into 
a red stop button. This button can be used to abort the process instead of 
typing x. 

Now, there is a second tab at the bottom of the TeXWork's window (Fig¬ 
ure 3.6). This lists the error message and provides a link to the line where 
the error occurred. Clicking on this link highlights line 1. Next I need to 
fix the error by correcting the spelling of the command. Once it's fixed, 
I can click on the build button. 

Here's another error you might encounter: I'm now going to misspell 
the class name. It should be scrartcl, but in Figure 3.7 it has been misspelt. 
This time, when I click on the build button, I get the error: 

! LaTeX Error: File ‘scrartc.cls’ not found. 

I hâve two choices: type in the correct name on the line below "Enter file 
name:" or I can abort the process using the red abort button. In either case 
I need to go back and fix the error in my code. 
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Figure 3.1 Source Code for an Example Document. (Syntax highlighting 
switched on.) 
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Figure 3.2 The Typeset Document 
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Figure 3.3 The Source Code Has a Misspelt Command 
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Figure 3.4 An Error Message is Displayed 
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t examplel.tex - TeXworks _| Ç 

File Edit Search Format Typeset Scripts Window Help 

:|Q pdfLaTeX H :| □ W & | & \ dL □ D 1 B S 

\documentclas{scrartcl} 

\begin{document} 

This is an example document. 

\end{document} 


Console output 

? h h 

The control sequence at the end of the top line 
of your error message was never \defed. If you hâve 
misspelled it (e.g., '\hobx'), type r and the correct 
spelling (e.g. f ' l\hbox‘). Otherwise just continue, 
and NI forget about whatever was undefined. 

? 

LF UTF-8 Line 1 Of 7; COl 13 


Figure 3.5 A Short Help Message 
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Figure 3.6 Error Tab 
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Figure 3.7 Misspelt Class File 








Chapter 4 

Creating a Simple Document 


Having installed and tested the software, let's now look at how to actually 
write the source code. The very first line of any document that you create 
must hâve the command: 

\documentclass [(option-list)] {( class-name }} 

This tells ETgX what type of document you want to create (for example an 
article, a technical report or correspondence). The \documentclass com¬ 
mand takes one mandatory argument, ( class-name }, that spécifiés the class 
file. 

There are many class files available, and some publishers, institutions 
or journals provide their own custom classes (for example, the jmlr class 
for the Journal of Machine Learning Research). Popular classes include 
memoir (for books and reports) and those supplied in the KOMA-Script bun- 
dle (for books, reports, articles and correspondence). There's also beamer 
(for présentations) as well as classes for typesetting exams, flashcards, con¬ 
cert programmes etc. For simplicity, this book will concentrate on three of 
the KOMA-Script classes scrartcl (for articles), scrreprt (for technical reports, 
theses etc) and scrbook (for books). 

We'll start with a very simple document, so let's use the scrartcl class file. 
In this case the very first line of the source code should be: 

\documentclass{ scrartcl} 

The \documentclass command also takes an optional argument, ( option- 
list), which should be a comma separated list of options to be passed to the 
class file. This allows you to override the class file defaults. For example, 
the scrartcl class file by default uses A4 paper, but if you are in the USA you 
will probably want to use letter paper. This can be achieved using the option 
letterpaper. So you would need to edit the above line to: 

\documentclass [letterpaper]{scrartcl} 

Let's change another option. The normal font size is llpt by default, but 
we hâve the option to change it, so let's use 12pt: 

\documentclass [letterpaper,12pt]{scrartcl} 

You can also change your document so that it is in a two-column format 
using the twocolumn option: 

\documentclass [letterpaper,12pt,twocolumn]{scrartcl} 

After deciding what type of document you want, you now need to specify 
the contents of the document. This is done inside the document environment. 
The document is started with the command: 
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\begin{document} nput 

and ended with 

\end{document} nput 

(ETgX stops reading the file when it reaches the above line, so anything 
occurring after it is ignored.) 

My source code now looks like: 


\documentclass [12pt]{scrartcl} 

\begin{document} 

\end{document} 

_I i Input 

Every document you create must hâve this form. You can't simply start 
typing the document text. You must first specify your class file, and then 
place the contents of the document inside the document environment. 

So far so good, but at the moment we hâve an empty document, so we 
won't get any output. Let's now put some text into our document: 


\documentclass [ 12pt]{scrartcl} 

\begin{document} 

This is a simple document. 

Here is the first paragraph. 

Here is the second paragraph. As you 
can see it’s 

a rather 

short paragraph, but not as short as the previous one. 
\end{document} 


t Input 


4- Input 


Top Five Mistakes Made bv New Users 

I first started teaching ETjrX in 1998, and these are the most common errors 
I've seen when people start learning ETgX: 

1. Missing out the backslash \ at the start of one or more of the com- 
mands. 

2. Using a forward slash / instead of a backslash \. 

3. Forgetting \end{document}. 

4. Misspelling "document" (in \begin{document} and \end{document}). 

5. Missing a closing brace }. 
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If you encounter any problems when you start out, go through that check 
list first. Then check Appendix B (Common Errors). 

Whenever you start a new document, always type in the \documentclass, 
\begin{document} and \end{document} commands first (Figure 4.1). Then 
move your cursor between the \begin and \end lines and type the document 
text (Figure 4.2). 


untitied-i.te> 


exwo 


File 


Edit Search Format 


pdfLaTeX 


Typeset Scripts 

J fü & | 


\documentclass{scra rtcl} 



Window Help 


, O 3 ^ 


\beg in {document} 
\end {document]} 



LF 

UTF-8 

Line 5 of 5; col 13 



Figure 4.1 Starting a New Document: always type these three lines first. 



Figure 4.2 Starting a New Document: move the cursor inside the document 
environment and start typing the document text. 

Exercise 1 (Simple Document) 

Try typing the code in the above example into TeXWorks or the editor 
of your choice (see Chapter 3 (From Source Code to Typeset Output) if you 
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can't remember what to do.) You can also download a copy of this file, but 
I recommend that you try typing it in to give yourself some practice. 

Things to note while you are typing: firstly, when you press the return 
character at the end of a line this end-of-line character is converted into a 
space in the output file. So the fact that I hâve some very ragged lines in 
my source code has no effect on the final resuit. (Note that some front-ends 
will reformat your lines as you type.) Whereas a completely blank line will 
be converted into a paragraph break (\par has the same effect). 

Secondly, multiple spaces are converted into a single space, so the large 
gap between the words "can" and "see" is no different from having a single 
space. 

Once you hâve typed up your source code, save your file (called, for 
example, exercisel.tex), and run PDFETgX as described in Section 3.1. 
If ail goes well, TeXWorks should display the resulting PDF file in a new 
window, usually alongside the window containing the source code. 

Notes: 

1. Each paragraph automatically starts with an indentation in the PDF. 

2. There is no blank line between the paragraphs in the PDF document. 
(See what happens if you add the KOMA-Script class option parskip= 
full: 

\documentclass[12pt ,parskip=full]{scrartcl} 
and rebuild the PDF.) 

3. Move the mouse over one of paragraphs in the PDF viewer and pop- 
up the context menu (usually a right mouse click). Select Jump to Source. 
The window containing the source code should now gain the focus and 
the line of code matching the typeset line you clicked on in the PDF 
should now be highlighted. 


4.1 Using Simple Commands 

Now let's try adding a few simple commands to our document. The com- 
mand \LaTeX produces the ETgX logo and the command \today prints the 
current date. ETj;X always ignores any spaces that follow a command name 
that consists of letters, as it uses the space to indicate the end of the com¬ 
mand name. This means that if we want a space to occur immediately after 
the command, we need to explicitly say so using the command (recall 
from page 8 indicates a space character). So, for example: 

VLaTeXX^logo 

produces the output: 

M^X logo 


Input 
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Some people when starting out can get a bit confused by this and read it as 
the entity "\LaTeX\" whereas it is in fact two commands: "\LaTeX" (print the 
logo) followed "\ " (print a space.) 

Let's also try using a command that takes an argument. The command 
\footnot e{(text)} 

takes one argument that spécifiés the text that should appear in the footnote. 
This command must be placed where you want the footnote marker to 
appear. 

Exercise 2 (Using Simple Commands) 

Edit the document you created in Exercise l, so that it looks like the 
following: (You can download it if you like, but again it is better if you try 
typing it in yourself.) 


\documentclass [ 12pt]{scrartcl} 

\begin{document} 

This is a simple \LaTeX\,_,document . Here is the first paragraph. 

Here is the second paragraph\footnote{with a footnote}. As you 
can see it’s a rather short paragraph, but not as short as the 
previous one. This document was created on: \today. 
\end{document} 


Now ETgX your document and view the resuit. (Remember to check 
Appendix B (Common Errors) if you hâve a problem.) You should see the 
ETgX logo, the footnote marker and the current date. If you scroll down to 
the bottom of the page, you should see the footnote. 


4.2 Packages 

Packages are files with the extension . sty that either define new commands 
or redefine existing commands. They're like a type of add-on or plug-in. 
Most of the commonly used packages should hâve been installed when you 
installed your TgX distribution (see Chapter 3 (From Source Code to Typeset 
Output)). Appendix A (Downloading and Installing Packages) covers how to 
install new packages. Most packages corne with documentation that can be 
accessed using the texdoc application described in Section l.l. 

Packages are loaded in the preamble (after \documentclass and before 
\begin{document}) using 
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\usepackage [(option lisf)] {(package)} 
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where ( package } is the name of the package and (option list } is a list of 
comma-separated options. For example, to load the package graphicx with 
the draft option: 

\usepackage [draft]{graphicx} 

Any applicable class options are also passed to packages, so in 

i i 

\documentclass [draft]{scrartcl} 

\usepackage {graphicx} 


the draft option is set for both the scrartcl class and the graphicx package. 

You can specify more than one package in the argument of \usepackage, 
where each package name is separated by a comma. For example: 

\usepackage{amsmath, amsfonts} 

The graphicx package is covered in Chapter 6 (The graphicx Package) and the 
amsmath package is covered in Chapter 9 (Mathematics), so let's start out 
with a relatively simple example. 

4.2.1 Changing fhe Format of \today 

In the previous exercise, we used the \today command to produce the 
current date. By default, this command displays the date in US format. To 
illustrate how to use packages, this section will look at how to use the datetime 
package to change the way that \today displays the date. 

The datetime package has various options that can be used to change the 
format of \today. For example, by default the datetime package redefines 
\today to display the date in the form: Tuesday 25 th September, 2012. The 
option short will produce an abbreviated form, (for example Tue 25 th Sept, 
2012) and the option nodayofweek won't display the day of the week (for 
example 25 th September, 2012). For those who don't like the raised ordinal, 
there is the level option. These can be passed as a comma separated list 
in the optional argument to the \usepackage command. It is also possible 
to use a déclaration instead. For example, to redefine \today to display the 
date in the form 25/09/2012, you can either do 

\usepackage [ddmmyyyy]{datetime} 

or 


\usepackage {datetime} 
\ddmmyyyydate 


The datetime package also defines the command 
\currenttime 

which displays the current time, where again the format can be changed by 
the package options. So the option 12hr will cause \currenttime to display 
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the date in 12 hour format (for example, 3:22pm) and the option 24hr will 
cause \currenttime to display the date in 24 hour format (for example, 
15:22). 

Exercise 3 (Using the datetime Package) 

Edit your document from Exercise 2 so that it uses the datetime package. 
Experiment with the different package options, for example 

\usepackage [short,nodayofweek,level,12hr]{datetime} 

and add the current time 

This document was created on: \today\,_,at \currenttime . 

You can download or view an example. For a full list datetime of package 
options, see the datetime documentation. (Refer to Section 1.1 on how to find 
package documentation.) 


4.3 Spécial Characters and Symbols 

You can use most of the standard characters that you find on your keyboard, 
but the 10 symbols shown in Table 4.1 hâve a spécial meaning. 

Table 4.1 Spécial Characters 


We hâve already used the curly braces { and }. The percent Symbol % is 
a comment character. Everything from the percent symbol up to the end 
of line is ignored by ETp;X. This means you can hâve comments in your 
source code to remind you what a particular part of your code is doing. We 
hâve also used the backslash symbol \ which indicates that we are using a 
command, as in \LaTeX or \today. The meaning of the other spécial 
characters will be covered later. 

So what do you do if you want one of these symbols to actually appear 
in your document? Table 4.2 lists commands that produce these and other 
symbols. Note that some of the commands hâve short cuts, such as — 
instead of \textemdash and ?‘ instead of \textquestiondown. 

The symbol ‘ is the backtick (or grave) symbol, as opposed to the apos¬ 
trophe symbol ’. The backtick symbol usually looks like ' on a keyboard, 
and on most UK keyboards it is situated to the left of the 1 key. The opening 
double quote is created using two adjacent backtick symbols and the closing 
double quote with two adjacent apostrophe symbols. This gives 66 and 99 
style quotes, which you wouldn't get using the double quote symbol on your 
keyboard. 

Note that the symbols | < and > hâve to be created using \textbar, 
\textless and \textgreater when in normal text mode. If you try to enter 
them using the corresponding keyboard characters you may get — j and 
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(They do however work if you are in maths mode. 41 ) The slash character 
/ may be used directly, as in "and/or", but no line break will be permitted 
at the slash, whereas \slash (as in "and\slash,_,or") will allow a line break 
at that point. 


Table 4.2 Symbols 


\textbackslash 

\ 

\slash 

/ 

\textgreater 

\textasciicircum 

A 

\$ 

$ 

\textbar 

\textascii tilde 

~ 

\{ 

{ 

\textless 

\pounds 

£ 

\} 

} 

\dag 

\textregistered 

® 

\# 

# 

\ddag 

\texttrademark 

TM 

\% 

% 

’ or \textquoteright 

\copyright 

© 

\& 

& 

‘ or \textquoteleft 

\textbullet 

• 

\i 

i 

’’ or \textquotedblright 

?‘ or \textquestiondown 

6 

\j 

J 

‘‘ or \textquotedblleft 

!‘ or \textexclamdown 

i 

- 

- 

-- or \textendash 

- or \textemdash 

— 

\s 

§ 

\textperiodcentered 

\ldots 

... 

\P 

1 

\_ or \textunderscore 


Ligatures and spécial symbols are shown in Table 4.3. (Note that, as 
mentioned in the introduction, the f-ligatures are automatically converted.) 
When using a command in the middle of a word, take care that the com- 
mand doesn't run into the rest of the word. For example, the British spelling 
of the word manœuvre has an œ-ligature in the middle of it. You will get 
an error if you try: 

man\oeuvre 

as ET^X will interpret it as the command \oeuvre which doesn't exist. 
There are several ways to code this in EŒ^X: 

1. Place a space after the command: 
man\oe,_,uvre 

2. Place an empty brace after the command: 
man\oe{}uvre 

3. Group the command: 
man{\oe}uvre 

(This can adversely affect the kerning so is best avoided.) 

English speakers are by and large very lackadaisical when it cornes to 
accents, but accents affect pronunciation, and so are just as important as 
the correct spelling. There is a big différence between putting your knife 


4.1 


There are also some text fonts that will display them correctly, but don't rely on it. 
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Table 4.3 Ligatures and Spécial Symbols (Computer Modem Font) 


\AE Æ 
fi fi 
\AA Â 

\0 0 


\ae æ 
ffi ffi 
\aa â 

\0 0 


\0E Œ 
fl fl 
\L L 
\SS SS 


\oe œ 
ffi fil 
\1 1 
\ss fi 


into someone's pâté (méat paste), and putting your knife into someone's pâte 
(head) ! 

Accented letters are created by specifying which accent you want, and 
the letter on which to put the accent. The accent commands are listed in 
Table 4.4, and each command takes one mandatory argument. The com- 
mand indicates what accent to use, and the argument indicates the letter on 
which to put the accent. 

You may hâve noticed in Table 4.2 the commands \i and \j which pro¬ 
duce a dotless i and j (î and j). With old versions of ET^X (or l^X) an accent 
over a normal "i" or "j" left the original dot in, which is incorrect, so a dotless 
"i" or "j" were required. With modem distributions, an accented "i" or "j" is 
correctly rendered. 

Example: 


It’s na\’ive to think that eating mouldy p\ A at\’e won’t resuit in 
food poisoning. 


Resuit: 

It's naïve to think that eating mouldy pâté won't resuit in food poi¬ 
soning. 


Table 4.4 Accent Commands 



Example 


Example 

Définition 

Input 

Output 

Définition 

Input 

Output 

V {(object)} 

\’{c} 

é 

\={(object)} 

\={c} 

c 

V {(object)} 

\‘{c} 

c 

\. {(object)} 

\.{c} 

c 

\ A {(object)} 

\ A {c} 

c 

\~ {(object)} 

\~{C} 

c 

\" {(object)} 

\"{c} 

c 

\v {(object)} 

\v{c} 

c 

\u {(object)} 

\u{c} 

c 

\H {(object)} 

\H{c} 

c 

\t {(object)} 

\t{xy} 

xy 

\c {(object)} 

\c{c} 

Ç 

\d {(object)} 

\d{c} 

c 

\b {(object)} 

\b{c} 

c 

\r {(object)} 

\r{c} 

O 

c 





This book only covers a very small subset of available Symbol commands. 
If the command you want isn't here, try Scott Pakin's comprehensive Symbol 
list [10]. Another useful resource is detexify. 


'l Input 
i Input 

Output 
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4.3.1 The inputenc Package 

Instead of using the accent and ligature commands described above, you 
can use the inputenc package and enter the character directly, but you must 
ensure you match the encoding with that used by your text editor. For 
example, this book uses UTF8 encoding so I hâve loaded the inputenc package 
in the preamble with the utf8 option: 

\usepackage [utf8]{inputenc} nput 

Note that it's a good idea to also use the fontenc package as well. For example, 
if you want to use Type 1 fonts: 


1 1 t Input 

\usepackage [Tl] {fontenc} 

\usepackage [utf8]{inputenc} 

I_I 4- Input 

Returning to an earlier example, I can directly enter the Unicode char¬ 
acter (U+0153) for the lower case œ ligature: 

manœuvre 

Note that if you are collaborating on a document and you want to use this 
approach, you must ensure that ail your co-authors use the same input 
encoding. For example, suppose you décidé to use ISO Latin 1 encoding 
(latinl option): 

\usepackage [latinl]{inputenc} 

but your co-author is using a UTF-8 editor and types: 

naïve 

where ï is the Unicode character U+OOEF. UTF-8 characters use one to 
four 8-bit bytes whereas ISO Latin 1 uses an 8-bit single-byte character set. 

So the U+OOEF binary sequence is interpreted by ISO Latin 1 encoding as 
two characters: Â (0xC3) and " (OxAF). Therefore the resulting PDF file 
will end up containing the rather odd looking: 

naÂ“ve X 

(If you are using TeXWorks, you can set your preferred encoding using 
Edit—>Preferences and select the "Editor" tab where there is an "Encoding" 
setting. Make sure this setting matches the inputenc option you use in your 
document.) 

Exercise 4 (Using Spécial Characters) 

Start a new file in TeXworks, and see if you can write the source code to 
create the output below. (Ignore any hyphenation that may appear below, 
does that automatically where necessary, see Section 2.14. Likewise, ig¬ 
nore where the line breaks occur, except for the paragraph break.) Choose 
whether you want to use the inputenc package or if you want to use com¬ 
mands such as \c, but in either case you need to be careful of the spécial 
characters. 
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Item #1: Our travel expenditure came to $2000.00 & our equipment 
expenditure came to £100.00 plus VAT @ 17.5%. 

Chloë collected Zoë from the crèche. They stopped to admire the façade 
of a new café and then went to a matinée. 


You can download or view the source code if you can't work out how to 
do it, and remember to check Appendix B (Common Errors) if you hâve a 
problem. 


4.4 Lists 

Now you've had a go at using some commands, let's use some environments 
(recall Section 2.15). A good example of environments are the list making 
environments. There are three basic list making environments: itemize (for 
unordered lists), enumerate (for ordered lists) and description (for lists where 
you want to specify your own label.) 

In each of these environments, each item in the list must be started with 
the command: 

\item [(marker)] 

The optional argument (marker) can be used to override the default marker 
for that particular item. (For example, to replace the bullet point for an 
individual item in an unordered list to make that item stand out from ail the 
other items.) We will be looking at how to change the default marker in 
Section 8.2. 

Related UK FAQ [ 18 ] topics: 

• Perhaps a missing \item? 

• Fancy énumération lists 

• Fiow to adjust list spacing 

• Interrupting enumerated lists 

• "Too deeply nested" 

4.4.1 Unordered Lists 

Unordered lists are created using the itemize environment. 

Example: 


\begin{ itemize} 
\item Animal 
\item Vegetable 


t Output 


4- Output 


Définition 


f Input 






Chapter 4 Creating a Simple Document 


49 


\item Minerai 
\end{itemize} 


• Animal 

• Vegetable 

• Minerai 


Another Example: 

Changing the default markers is covered in Section 8.2, but it's also possible 
to override the default marker for a particular item, as in this example 
(recall the double-dagger Symbol command \ddag from Table 4.2): 


\begin{itemize} 

\item Animal 
\item[\ddag] Vegetable 
\item Minerai 
\end{itemize} 


• Animal 

J Vegetable 

• Minerai 


Be careful about using square brackets [] inside an optional argument. 
Grouping is required, as in: 


\begin{itemize} 

\item Animal 
\item[{[X]}] Vegetable 
\item Minerai 
\end{itemize} 


• Animal 
[X] Vegetable 

• Minerai 


4- Input 


t Output 


4 Output 


4 Input 


4 Input 


4 Output 


4 Output 


4 Input 


4 Input 


4 Output 


4 Output 


Similarly if the item starts with an open square bracket [, as in: 
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\begin{itemize} 

\item Animal 
\item {[sic]} Wegetable 
\item Minerai 
\end{itemize} 

, , i Input 


1 t Output 

• Animal 

• [sic] Wegetable 

• Minerai 


i Output 


Nested Lists 

It is also possible to nest itemize environments. The following example has 
three levels, each using its own default marker. 


\begin{ itemize} 

\item Animal 
\begin{ itemize} 

\item Mammals 
\item Birds 

\item Reptiles. For example: 

\begin{ itemize} 

\item dinosaurs 
\item crocodiles 
\end{itemize} 

\end{itemize} 

\item Vegetable 
\begin{ itemize} 

\item Cultivated 
\item Wild 
\end{itemize} 

\item Minerai 
\end{itemize} 

, i i Input 


1 t Output 

• Animal 

- Mammals 

- Birds 

- Reptiles. For example: 
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* dinosaurs 

* crocodiles 

• Vegetable 

- Cultivated 

- Wild 

• Minerai 


I_I l Output 

You might hâve noticed the code in the above example is a little difficult 
to read. Each new list item starts a new paragraph, so it doesn't matter if 
we hâve blank lines before each item. Also, recall from Chapter 2 (Some 
Définitions) that spaces at the start of each line of code are ignored, so it's 
possible to make the code more readable without affecting the final resuit: 


\begin{itemize} 

\item Animal 
\begin{i ternize} 

\item Mammals 
\item Birds 

\item Reptiles. For example: 
\begin{itemize} 

\item dinosaurs 
\item crocodiles 
\end{itemize} 

\end{itemize} 

\item Vegetable 
\begin{itemize} 

\item Cultivated 
\item Wild 


t Input 


\end{itemize} 
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\item Minerai 
\end{itemize} 

I_I i Input 

It's now a little easier to see which \begin{itemize} matches up with 
the corresponding \end{itemize}. 

Example (Four Levels) 

This example has four levels, which is the maximum allowed by most 
classes. 


1 1 î Input 

\begin{itemize} 

\item Animal 

\begin{itemize} 

\item Mammal 

\begin{i terni ze} 

\item Placental 

\item Monotreme 

\begin{itemize} 

\item Platypus 
\end{itemize} 

\item Marsupial 

\begin{itemize} 

\item Kangaroo 

\item Koala 
\end{itemize} 

\end{itemize} 

\item Reptile 
\end{itemize} 

\item Vegetable 

\item Minerai 
\end{itemize} 


4- Input 
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t Output 

• Animal 

- Mammal 

* Placental 

* Monotreme 

• Platypus 

* Marsupial 

• Kangaroo 

• Koala 

- Reptile 

• Vegetable 

• Minerai 


I_I i Output 

If you try adding a further level, ETp;X will give a "Too deeply nested" 
error. 

4.4.2 Ordered Lisfs 

Ordered lists are created using the enumerate environment. It has exactly the 
same format as the itemize environment described above. 

We can use the same example as before, only this time use enumerate 
instead of itemize. 


1 t Input 

\begin{ enumerate} 

\item Animal 
\item Vegetable 
\item Minerai 

\end{ enumerate} 

!_! t Input 

The above input will produce the following output: 


t Output 

1. Animal 

2. Vegetable 

3. Minerai 


t Output 


As before, the marker for a particular item can be overridden: 
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\begin{enumerate} 

\item Animal 
\item[{[X]}] Vegetable 
\item Minerai 
\end{enumerate} 

, , i Input 


1 f Output 

1. Animal 
[X] Vegetable 

2. Minerai 


i Output 


Example (Nested): 

As with the itemize environment, most classes allow a maximum of four 
nested enumerate environments. 


1 1 î Input 

\begin{ enumerate} 

\item Animal 

\begin{ enumerate} 

\item Mammal 

\begin{ enumerate} 

\item Placental 

\item Monotreme 

\begin{enumerate} 

\item Platypus 
\end{ enumerate} 

\item Marsupial 

\begin{enumerate} 

\item Kangaroo 

\item Koala 
\end{ enumerate} 

\end{ enumerate} 


\item Reptile 
\end{ enumerate} 
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\item Vegetable 

\item Minerai 
\end{enumerate} 

i 1 Input 


t Output 

1. Animal 

a) Mammal 

i. Placental 

ii. Monotreme 
A. Platypus 

iii. Marsupial 

A. Kangaroo 

B. Koala 

b) Reptile 

2. Vegetable 

3. Minerai 


i Output 


4.4.3 Description Environment 

The description environment has the same format as the itemize environment 
described in Section 4.4.1, only this time you need to specify a marker as an 
optional argument to the \item command, since there is no default marker 
for this environment. The marker may be a textual label, and most classes 
will typeset it in bold. The KOMA-Script classes, such as scrartcl, default to a 
bold sans-serif font, as illustrated in this next example: 


\begin{de scription} 

\item [Animal] Living being 

\item[Vegetable] Plant 

\item [Minerai] Natural inorganic substance 
\end{description} 


t Input 


i Input 


t Output 


Animal Living being 







Chapter 4 Creating a Simple Document 


56 


Végétable Plant 

Minerai Natural inorganic substance 


|_| 4; Output 

The KOMA-Script classes provide a way of changing the font style in the 
description label markers. (The font changing commands \normalfont and 
\scshape will be covered in Section 4.5, and the KOMA-Script command 
\addtokomafont in Section 5.3.) 


\addtokomafont{descriptionlabel}{\normalfont\scshape} 
\begin{de scription} 

\item [Animal] Living being 

\item[Vegetable] Plant 

\item [Minerai] Natural inorganic substance 
\end{description} 


t Input 


4- Input 


1 t Output 

Animal Living being 
Vegetable Plant 

Minéral Natural inorganic substance 


I_I i Output 

It is possible to nest ail the listing environments, as long as you don't 
exceed four itemize and four enumerate environments. The description environ¬ 
ment has no restriction on the number of times it can be nested. However, 
just because you can do something, doesn't mean you should. In general 
it's best to avoid an excessively complicated block of text in your document. 

Example (Assorted Nesting): 

This example uses each of the listing environments described above. 


1 t Input 

\begin{de scription} 

\item [Animal] Living being 
\begin{ itemize} 

\item Mammals 


\item Birds 








Chapter 4 Creating a Simple Document 


57 


\item Reptiles. For example: 
\begin{enumerate} 

\item dinosaurs 
\item crocodiles 
\end{enumerate} 

\end{itemize} 

\item[Vegetable] Plant 
\begin{itemize} 

\item Cultivated. For example: 
\begin{enumerate} 

\item Carrots 
\item Broccoli 
\item Potatoes 
\end{enumerate} 

\item Wild 
\end{itemize} 

\item [Minerai] Natural inorganic substance 
\end{description} 


Animal Living being 

• Mammals 

• Birds 

• Reptiles. For example: 

1 . dinosaurs 

2 . crocodiles 


4- Input 


t Output 


Végétable Plant 
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• Cultivated. For example: 

1. Carrots 

2. Broccoli 

3. Potatoes 

• Wild 

Minerai Natural inorganic substance 


Exercise 5 (Lists) 

Try writing the source code that will create the output shown below. 


Village A small collection of dwelling places. Examples: 

1. Marlingford 

2. Saxlingham Nethergate 

Town A large collection of dwelling places. Examples: 

1 . Great Yarmouth 

2. Beccles 

City A large town, usually containing a cathédral. Examples: 

1. Norwich 

2. Birmingham 

3. London 


You can download or view the answer if you can't work out how to do it. 


4.5 Fonts 

uses Donald Knuth's Computer Modem fonts by default. This supplies 
three font families: serif, sans-serif and a typewriter (or monospaced) font 
(as well as the maths fonts which are discussed in Section 9.4.1). With each 
font family, you can change the shape and weight, as well as the size. 


i Output 


î Output 


4- Output 


[FAQ: Using 
PostScript fonts 
with TeX] 
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4.5.1 Changing the Font Style 

There are two basic ways of changing fonts: you can either change the 
font for a small sélection of text, for example, if you want to emphasize a 
word, or you may wish to change the font "from this point onwards". The 
commands shown in Table 4.5 are of the first type (text-block commands), 
whereas those shown in Table 4.6 are of the second type — a déclaration (or 
modal command). 

Note: 

Don't be tempted to use \bf, \md, \it, \sl, \sc, \sf, \tt or \rm. These 
commands are obsolète [15]. 

If you use an italic or slanted font déclaration, such as \itshape, you will 
need to add an italic correction \/ at the end of the block of text, when 
the last letter of the sloping text leans too far over. This isn't necessary for 
text-block commands, such as \textit, just for the modal commands. The 
effect is more noticeable when part of a word is stressed, particularly with 
certain fonts. 

Example: 

In the code below, the first instance of "repeated" doesn't hâve an italic 
correction but the second does: 

{\itshape repeated}ly {\itshape repeated\/}ly 

Using Computer Modem: 

repeated ly repeatedlj 

Using Helvetica: 

repeated ly repeated ly 

Using Antykwa Torurïska typeface: 

repeatedly repeatedly 

Note that if you want to typeset an URL, rather than using \texttt it is 
better to use 

\url {(address)} 

which is defined in the url package. For example: 

\url{http ://theoval.cmp.uea. ac.uk/~nlct/} 
produces: 

http://theoval.cmp.uea.ac.uk/~nlct/ 

(Note there is no need to do anything with the ~ (tilde) spécial character if 
you use it in the argument of \url.) 

Environments can be used instead. Each environment has the same 
name as its corresponding déclaration, but without the preceding backslash. 
For example: 

\begin{sffamily}Some sans-serif text. \end{sffamily} 
yields: 


A 

[FAQ: What's 
wrong with \bf, 
\it etc.?] 


Input 

Output 

Output 

Output 


Définition 


Input 

Output 


Input 
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Table 4.5 Font Changing Text-Block Commands 


Command 

Example Input 

Corresponding output 

(Computer Modem) 

\textrm{(fexf)} 

\textrm{roman} text 

roman text 

\textsf {(text)} 

\textsf{sans serif} text 

sans serif text 

\texttt {(text)} 

\texttt{typewriter} text 

typewriter text 

\textmd{(fexf}} 

\textmd{medium} text 

medium text 

\textbf{(fexf}} 

\textbf{bold} text 

bold text 

\textup{(fexf}} 

\textup{upright} text 

upright text 

\textit{(fexf}} 

\textit{italic} text 

Italie text 

\textsl{(fexf}} 

\textsl{slanted} text 

slanted text 

\textsc{(fexf}} 

\textsc{Small Caps} text 

Small Caps text 

\emph{(fexf}} 

\emph{emphasized} text 

emphasized text 

\textnormal{(fexf}} \textnormal{default} text 

default text 


Table 4.6 Font Changing Déclarations 


Déclaration 

Example Input 

Corresponding output 

(Computer Modem) 

\rmfamily 

\sffamily 

\ttfamily 

\rmfamily roman text 
\sffamily sans serif text 
\ttfamily typewriter text 

roman text 

sans serif text 
typewriter text 

\mdseries 

\bfseries 

\mdseries medium text 
\bfseries bold text 

medium text 

bold text 

\upshape 

\itshape 

\slshape 

\scshape 

\upshape upright text 
\itshape italic text 
\slshape slanted text 
\scshape Small Caps text 

upright text 
italic text 
slanted text 

Small Caps text 

\em 

\em emphasized text 

emphasized text 

\normalfont 

\normalfont default text 

default text 
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Some sans-serif text. 

You can combine a font family with a given shape and weight using a 
variety of methods. 

Examples: 

1. Localised déclarations: 

{\sffamily\slshape Some slanted sans-serif text.} 

2. Déclarations that later get explicitly reset: 

\sffamily\slshape Some slanted sans-serif 
text. \normalfont 

3. Mixing text-block and modal commands: 

\textsf{\slshape Some slanted sans-serif text.} 

4. Nested commands: 

\textsf{\textsl{Some slanted sans-serif text.}} 

5. Mixing environments and déclarations: 


\begin{sffamily}\slshape Some slanted sans-serif 
text. \end{sffamily} 


Ail of the above produce the same output: 

Some slanted sans-serif text. 

Note that some combinations are not available, in which case ETgX will 
give a warning message, and will substitute the font for what it considers to 
be the closest available match. 

Example: 

\textsc{\bfseries Text} 

With the Antykwa Torurïska typeface, this appears as: 

Text 

whereas with Computer Modem, the resuit is: 

Text 

This is because Computer Modem doesn't hâve a bold small-caps font, so 
it just uses bold. ETgX gives the following warning: 

LaTeX Font Warning: Font shape ‘Tl/cmr/b/sc’ undefined 

(Font) using ‘Tl/cmr/b/n’ instead on input line 2792. 


Output 


Input 


Input 


Input 


Input 


t Input 

i Input 


Output 

[FAQ: Warning: 
"Font shape ... 
not available"] 


Input 


Output 


Output 
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Most sans-serif fonts don't provide a small-caps variant, so 
\textsf{\scshape Text} 

will either appear in regular sans-serif or small-caps serif, depending on the 
font in use. Using Libris sans-serif the resuit is: 

Text 

whereas using Computer Modem Sans, the resuit is: 

Text 

Emphasizing Words or Phrases 

The command \emph, the déclaration \em and the environment em behave 
slightly differently to the corresponding \textit command, \itshape déc¬ 
laration and itshape environment. The latter group simply use an italic font, 
whereas the former will toggle between sloping and upright. So if the sur- 
rounding font is upright then \emph, \em and em will use the sloping font, 
but if the surrounding font is italic or slanted, \emph, \em and em will use 
an upright font. This is particularly useful in abstracts where the abstract 
font varies between class files. It is recommended that if your intention is 
to emphasize something, you should use \emph etc. rather than \textit etc. 


Examples: 

1. Emphasized text in upright surrounding: 

Some \emph{ emphasized} text. 

yields 

Some emphasized text. Output 

2. Emphasized text in italic surrounding: 

{\itshape Some \emph{emphasized} text.} 
yields 

Some emphasized text. Output 

3. Emphasized text in upright sans-serif surrounding: 

{\sffamily Some \emph{emphasized} text.} 
yields 

Some emphasized text. 


Input 


Output 


Output 


Output 
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4.5.2 Changing the Font Size 

When you start writing a document, you need to décidé what the base font 
size should be. The KOMA-Script classes default to llpt, but this can be 
changed using the class options 8pt, 9pt, 10pt, 12pt, 14pt, 17pt or 2®pt. 

You can then change the font size relative to the base size, using one of 
the déclarations shown in Table 4.7. That way, if you later décidé to change 
the normal font size from, say, llpt to 12pt, ail you need do is change the 
class option (see page 38) and re-run ET|SK. Note that there are no équivalent 
text-block commands. 

Table 4.7 Font Size Changing Déclarations 


Déclaration 

Example Input 

Corresponding Output 

\tiny 

\tiny tiny text 

tiny text 

\scriptsize 

\scriptsize script size 

script size 

\footnotesize 

\footnotesize footnote size 

footnote size 

\small 

\small small text 

small text 

\normalsize 

\normalsize normal size 

normal size 

\large 

\large large text 

large text 

\Large 

\Large even larger 

even larger 

\LARGE 

\LARGE larger still 

larger still 

\huge 

\huge huge 

huge 

\Huge 

\Huge extra huge 

extra huge 


Again, environments can be used instead, where each environment has 
the same name as its corresponding déclaration, but without the preceding 
backslash. Font environments may be nested, for example: 


\begin{itshape} Some italic text. \begin{Large}This text is 
large. \end{Large} \end{itshape} Back to normal. 

Output: 

Some italic text. This text is large. Back to normal. 


t Input 
4- Input 

Output 


4.5.3 Changing Document Fonts 

What if you don't want to use the default Computer Modem fonts? Some 
publishers and institutions insist on a combination of Times Roman (serif), 
Flelvetica (sans-serif) and Courier (typewriter). To do this, you can load the 
following packages: 


[FAQ: Choice of 
scalable outline 
fonts] 


mathptmx (Times) Only affects \rmfamily and \textrm. 


helvet (Helvetica) Only affects \sffamily and \textsf. 


courier (Courier) Only affects \ttfamily and \texttt. 
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Notes: /î\ 

1. Don't be tempted to use the times package. It's obsolète [15]. Use math- 
ptmx instead. 

2. Although Times and Helvetica are commonly used together, they don't 
match, as illustrated below (temporarily switching from this book's 
fonts to Times and Helvetica): 

\rmfamily xx \sffamily xx 

Results in: 

XX XX Output 

The first two x's are in Times Roman and the second two are in Hel¬ 
vetica, which are somewhat larger. To compensate for this you need 
to scale the Helvetica font using the scaled option: 

\usepackage [scaled=0. 9] {helvet} 

3. Loading helvet or courier doesn't change the default font family. Consider 
the following: 

\documentclass{scrartcl} 


\usepackage {helvet} 

\begin{document} 

This is a sample document. 

\end{document} 

Here, the text "This is a sample document" will be typeset in Computer 
Modem Roman. This is because \rmfamily is the default font and helvet 
only affects \sffamily, which hasn't been used. (See Section 8.2 to find 
out how to change the default font family.) 

This book has used the following packages: 

\usepackage [Tl] {fontenc} 

\usepackage [math]{anttor} 

\usepackage{libris} 

[FAQ: Why 
bother with 
inputenc and 
fontenc?] 

Go back to the document you created in Exercise 1 and change the first 
paragraph to a large bold font and the second paragraph to normal size 
italic. Emphasize the words "simple" and "short". (Again, you can download 
or view the solution.) 


The fontenc package is used to switch to Type 1 font encoding, the anttor 
package is used to set the serif family to Antykwa Torurïska typeface, and the 
libris package is used to set the sans-serif family to the Libris ADF typeface. 

Exercise 6 (Fonts) 
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If you like, you can try experimenting with loading different font pack¬ 
ages, such as mathptmx, to change the default typeface. The ETp;X Font Cat¬ 
alogue [2] provides a useful list of fonts, although you may not hâve ail of 
them installed. 


4.6 Aligning Material in Rows and Columns 

Text can be aligned in rows and columns using the tabular environment. 
\begin{tabular} [(pos)] {( column specifiers )} 

This environment has a mandatory argument ( column specifîers) that spéc¬ 
ifiés how to align each column. Within ( column specifiers), there must be 
a spécifier for each column. The three basic are: r (right aligned), 1 (left 
aligned) and c (centred). (Make sure you don't confuse 1 (the letter "ell") 
with 1 (the digit one).) The optional argument (pos) is covered in Section 4.7. 

Example: 

Three columns (left, centred, centred): 

\begin{tabular}{lcc} 

Another Example: 

Four columns (left, centred, centred, right): 

\begin{tabular}{lccr} 

The r, 1 and c specifiers don't allow line breaks or paragraphs within a 
cell. It's not a good idea to hâve too much text in a cell, but if it's required 
you can use 

p {(width)} 

which indicates a paragraph cell of the given width. 

Example: 

Three columns (paragraph of width lin, centred, right): 

\begin{ tabular} {p{ lin}cr} 

The paragraph cell will be formatted fully justified, which is often inappro- 
priate for a narrow block of text. The array package provides 

>{ (déclaration)} 

which can be used directly in front of the 1, c, r or p column specifiers. 
This inserts ( déclaration) in front of the entries for that column, so it can 
be used to insert, say, \raggedright. 

Example: 

Three columns, the first left justified where each entry is in bold, the second 
a paragraph column of width lin set to ragged right and the third centered: 
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\begin{tabular }{>{\bfsériés} l>{\raggedright}p{lin}c} 

The array package also provides 

<{(declaration }} 

which can be used directly after the 1, c, r or p column specifiers. This 
inserts ( déclaration } after the entries for that column. 

Inter-Column Gap: 

The gap between columns is given by twice the value of the length register: 
\tabcolsep 

A gap of \tabcolsep is also inserted before the first column and after the last 
column. This length can be changed using one of the commands described 
in Section 2.17. For example: 

\setlength{\tabcolsep}{4pt} 

This will put an 8pt gap between columns and a 4pt gap before the first 
column and after the last column. 

The column specifiers can also include: 

( H(inter-column text }} 

This inserts ( inter-column text } at that place on each row of the table, re- 
placing the default inter-column gap. 

Example: 

Suppose we want a centred first column, a right justified second column 
and a left justified third column with a dot between the second and third 
columns: 

\begin{tabular}{cr@{ . }1} 

Alternatively, you may want a larger gap between groups of columns, for 
example, two groups of three left justified columns: 

\begin{tabular}{lll@{\hspace{4\tabcolsep}}lll} 

This uses the command: 

\hspace { ( length ) } 

which inserts a horizontal space of a given length. In this case, four times 
the value of \tabcolsep. This makes the gap between the third and fourth 
columns twice as wide as the gap between the other columns. 

4.6.1 Column and Row Séparation 

Remember the spécial characters mentioned in Section 4.3? The ampersand 
character & is used to separate column entries. Rows are separated using: 
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where (vertical space } is extra vertical spacing between rows, if required. 
There is also a longer équivalent: 

\tabularnewline 

If you hâve used something like >{\raggedright}p{(lengfh}} as the spéc¬ 
ifier for your last column, you must use \tabularnewline instead of \\ to 
indicate the row break otherwise you will get the following error: 

! Extra alignment tab has been changed to \cr. 
crecently read> \endtemplate 

Example: 

Let's hâve two columns, the first left justified and the second right justified: 


\begin{tabular}{lr} 
Video & 8.99\\ 

CD & 9.11\\ 

DVD & 15.00W 
Total & 33.10 
\end{tabular} 


Video 8.99 
CD 9.11 
DVD 15.00 
Total 33.10 


Recall from Chapter 2 (Some Définitions) that ETjrX ignores spaces at the 
start of a line and treats multiple spaces as a single space, so I could just 
hâve easily done: 


\begin{tabular}{lr} 

Video & 8.99\\ 

CD & 9.11\\ 

DVD & 15.00W 
Total & 33.10 
\end{tabular} 

i_i 

and still hâve got the same resuit, but now the code is easier to read. 

Entries form implicit grouping, so déclarations made within a tabular en¬ 
vironment only hâve an effect up to the next & or \\. 

Example: 


\begin{tabular}{lr} 
Video & 8.99\\ 

CD & 9.11\\ 
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DVD & 15.0Q\\ 
\bfseries Total & 33.1® 
\end{tabular} 

Output: 


1 

Video 

8.99 

1 t Output 

CD 

9.11 


DVD 

15.00 


Total 

i_ 

33.10 

1 J, Output 


Let's add an extra column and a header row: 


\begin{tabular}{lrr} 

Item & ex VAT & inc VAT\\ 

Video & 8.99 & 18.56 \\ 

CD & 9.11 & 18.78 \\ 

DVD & 15.Q® & 17.63 \\ 

\bfseries Total & 33.1® & 39.89 

\end{tabular} 


Output: 


1 

Item 

ex VAT 

inc VAT 

1 t Output 

Video 

8.99 

10.56 


CD 

9.11 

10.70 


DVD 

15.00 

17.63 


Total 

1_ 

33.10 

39.89 

t Output 


Example (Aligning on a Décimal Point): 

If you want to align on the décimal point, it's best to use the siunitx package. 
That's beyond the scope of this book, but for simple data this can be achieved 
using the @ inter-column spécifier. For example: 


\begin{tabular}{lr@{ . }1} 
Video & 8 & 99\\ 

CD & 9 & 11\\ 

DVD & 15 & ®0\\ 
\bfseries Total & 33 & 1® 
\end{tabular} 


Output: 
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Video 8.99 
CD 9.11 
DVD 15.00 
Total 33.10 


4.6.2 Spanning Columns 

You may hâve noticed I omitted the column headers in the above example. 
The problem with rewriting the table using r@{ . }1 to align the décimal point 
is that the header now needs to span the last two columns. This can be done 
using the command: 

\multicolumn{(cols spanned)}{(col spécifier}} {(text)} 

The first mandatory argument (cols spanned) is the number of columns 
you want to span, the second argument (col spécifier) indicates how to 
align this column-spanning entry, the third argument (text) indicates what 
should go in this entry. Note that (col spécifier) should only hâve a single 
column spécifier, such as {c} or {r}. We can use \multicolumn to modify 
an earlier example as follows: 


\begin{tabular}{lrr} 

& \multicolumn{2}{c}{Price (\pounds)}\\ 
Item & ex VAT & inc VAT\\ 

Video & 8.99 & 18.56 \\ 

CD & 9.11 & 18.78 \\ 

DVD & 15.00 & 17.63 \\ 

\bfseries Total & 33.10 & 39.89 

\end{tabular} 

Output: 


Price (£) 


Item 

ex VAT 

inc VAT 

Video 

8.99 

10.56 

CD 

9.99 

11.74 

DVD 

15.00 

17.63 

Total 

33.98 

39.93 


Here we are spanning two columns, so the first argument to \multicolumn 
is {2}, we want the entry centred, so the second argument is {c} and the 
text to go in this entry is simply {Price (\pounds)}. 

The \multicolumn command can also be used to override the alignment 
of individual entries. Consider the following example: 
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\begin{tabular} {lrr} 

& Yearl & Year2 \\ 
Travel & 100,000 & 110,000\\ 
Equipment & 50,000 & 60,000 
\end{tabular} 


Output: 

1 

Yearl 

i 

Year2 

Travel 

100,000 

110,000 

Equipment 

1_ 

50,000 

60,000 

i 


In this example, the headers "Yearl" and "Year2" would look better centred, 
but the rest of the entries in the second and third columns look best right 
aligned. We can use \multicolumn to span just one column, and use the 
second argument of \multicolumn to override the column spécification: 


\begin{tabular} {lrr} 

& \multicolumn{l}{c}{Yearl} 

& \multicolumn{l}{c}{Year2}\\ 
Travel & 100,000 & 110,00O\\ 
Equipment & 50,000 & 60,000 
\end{tabular} 


Output: 

1 

Yearl 

1 

Year2 

Travel 

100,000 

110,000 

Equipment 

i_ 

50,000 

60,000 

i 


4.6.3 Rules 

In general, vertical rules are considered superfluous [11]. Although Tura- 
bian [17] allows for the possibility of vertical rules for tabulated material 
containing more than two columns but still advises against having too many 
and deprecates the use of them at either end. 

Horizontal rules may be used at the top and bottom of the tabulated ma¬ 
terial, but other horizontal rules should be kept to a minimum. In general, 
the top and bottom rule should be thicker than the mid rules. 

The booktabs package provides: 

\toprule [(wd)] 

for the top horizontal rule, 

\bottomrule [(wd)] 
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for the bottom horizontal rule, and 

\midrule [(wd)] Définition 

for horizontal rules in between rows, such as after the header row. 

These commands should ail go at the start of the appropriate row. This 
means that if you want a bottom rule, you need to add \\ followed by 
\bottomrule at the end of the tabulated material. 

Example: 


\begin{tabular}{lrr} 

\toprule 

& \multicolumn{l}{c}{Yearl} 

& \multicolumn{l}{c}{Year2}\\ 

\midrule 

Travel & 100,00® & 11®,0®0\\ 
Equipment & 50,000 & 60,000\\ 
\bottomrule 
\end{tabular} 


results in: 


t Input 
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1 



1 t Output 


Yearl 

Year2 

Travel 

100,000 

110,000 


Equipment 

50,000 

60,000 

1 4- Output 

1_ 




The thickness of the top and bottom rule is given by the length register 
\heavyrulewidth, and the thickness of the mid rule is given by the length 
register \lightrulewidth. These rule thicknesses can be overridden using 
the optional argument (wd) for \toprule, \midrule and \bottomrule. 

Exercise 7 (Aligning Material) 

Go back to the document you created in Exercise 2 (and later modified 
in Exercise 3), and add the following: 


1 

Expenditure (£) 

1 t Output 


Yearl 

Year2 


Travel 

100,000 110,000 


Equipment 

1_ 

50,000 

60,000 

4 Output 


Note that the tabular environment doesn't create a caption, ail it does is 
arrange its contents in rows and columns. You can find out how to turn 
your tabular environment into a table in Section 7.2. 

You can download or view the solution to this exercise. (Remember to 
check Appendix B (Common Errors) if you encounter an error message.) 
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For more information about using the tabular environment see BTgX: A 
Document Préparation System [9], A Guide to BTgX [7] or The BTgX Com- 
panion [3]. The BT^X Companion also describes how to span rows using 
the multirow package. For information on how to create coloured tables using 
the colortbl package, see The BTfX Graphics Companion [5]. 

Related UK FAQ [ 18 ] topics: 

• How to change a whole row of a table 

• Merging cells in a column of a table 

• Fixed width tables 

• Variable-width columns in tables 

• Spacing lines in tables 


4.7 Boxes and Mini-Pages 


T^X views everything on a page as a form of box. Each box has an associated 
width, height and depth, and the boxes are placed together on the page 
with glue. This is reminiscent of the days of manual typesetting, where 
each letter or Symbol was on a wooden block, and the wooden blocks were 
glued in place. The simplest form of box is a single letter. Some letters, 
such as "a" only hâve a height and width, whereas other letters, such as "y" 
hâve a height, width and depth (see Figure 4.3). 


A 


height 

> i 

A 

depth „ 



< - > < - > 

width width 


Figure 4.3 TgX Views Each Letter as a Box 


For example, the phrase "cabbages and peas" is made up of 15 boxes: 



and p eas 


whereas the word "cauliflower" consists of 10 boxes : 42 


4 2 The fl-ligature is a single character, and so is one box not two. 
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muMowieir 


More complicated boxes are made up of smaller boxes. We hâve already 
encountered one of these more complicated boxes: the tabular environment, 
discussed in the previous section. This type of box is called a horizontal 
box, which means that it can go in a line of text. For example: 


Here is some text. 
\begin{tabular}{cc} 

A & B\\ 

C & D 

\end{tabular} 

The rest of the line. 

produces: 


Here is some text. ^ ^ The rest of the line. 


Recall from the previous section that the tabular environment had an optional 
argument (pos). This governs the vertical alignment when the tabular envi¬ 
ronment occurs within a line of text. This can be one of c (centred — the 
default, as illustrated above), t (top) and b (bottom). For example, 


Here is some text. 
\begin{tabular}[b] {cc} 
A & B\\ 

C & D 

\end{tabular} 

The rest of the line. 


produces: 


A B 

Here is some text. C D The rest of the line. 


Since a box can't be broken across a line of text, you can use the box 
making command: 

\mbox{(fexf}} 

to prevent (text) from spanning a line break. 

Example: 

Compare: 
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\raggedright Some text at the beginning of a paragraph. Some text 
in the middle of the paragraph. Some more text. \par 


Some text at the beginning of a paragraph. Some text in the middle of the 
paragraph. Some more text. 


with: 


\raggedright Some text at the beginning of a paragraph. 
\mbox{Some text in the middle of the paragraph.} Some more text. 
\par 


Some text at the beginning of a paragraph. 

Some text in the middle of the paragraph. Some more text. 


(If \raggedright had not been used, the text in the \mbox would've spilt out 
over the edge of the page.) 

Another type of box which can again be placed in a line of text, is the 
minipage environment. 

\begin{minipage} [(pos)] [(height)] {( width )} 

As the name suggests, this environment créâtes a "mini-page" of the given 
width. 

Example: 


Some text. 

\begin{minipage}{2in} 

This is a mini-page. The text inside it is formatted as usual. 

Paragraph breaks can also be used, but there is no indentation by 
default\footnote{and this is how a footnote appears}. 
\end{minipage} 

The rest of the line. 
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This is a mini-page. The 
text inside it is formatted 
as usual. 

Paragraph breaks can 

Some text. also be used; but there is The rest of the line. 

no indentation by default 3 . 

a and this is how a footnote ap- 
pears 


You can optionally specify a height, and how the mini-page is aligned 
with the rest of the text. As with the tabular environment, the alignment 
option (pos) can be one of t (top), c (centred) or b (bottom). The default 
is c, which is why the above example has the mini-page centred vertically. 
This can be changed, for example: 


Some text. 

\begin{minipage} [t] {2in} 

This is a mini-page. The text inside it is formatted as usual. 

Paragraph breaks can also be used, but there is no indentation by 
default\footnote{and this is how a footnote appears}. 
\end{minipage} 

The rest of the line. 


which produces 


Some text. This is a mini-page. The The rest of the line, 
text inside it is formatted 
as usual. 

Paragraph breaks can 
also be used, but there is 
no indentation by default 3 . 

a and this is how a footnote ap¬ 
pears 


Note that the width can be specified relative to the current line width, 
using the length register \linewidth. For example, 

\begin{minipage}{® . 5\linewidth} 

will start a mini-page that is half the width of the current line. 

There is also a corresponding command 

\parbox [(pos)] [( height )] {(width)} {(text)} 

which behaves in a similar way. So the above example can be rewritten 
using a \parbox: 
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Some text. 

\parbox[t] {2in}{This is a parbox. The text inside it is formatted 
as usual. 

Paragraph breaks can also be used, but there is no indentation by 
default. } 

The rest of the line. 


which produces 


Some text. This is a parbox. The text The rest of the line, 
inside it is formatted as 
usual. 

Paragraph breaks can 
also be used, but there is 
no indentation by default. 


You may hâve noticed that the \footnote command has not been used in the 
above example. The \parbox command is more restricted than the minipage 
environment, so you can't use the \footnote command in it. There are also 
certain environments, such as the list-making environments described in 
Section 4.4, that can be used in a minipage but not in a \parbox. 


4.7.1 Framed Boxes 


Recall the \framebox command described in Section 2.8.2: 

\framebox [(vvidfh)] [( align )] {(text)} 

This treats (text) as a box of width ( width ) and puts a frame around it. The 
second optional argument may be one of: c (centred contents), 1 (left-aligned 
contents), r (right-aligned contents). 

Example: 

Some \framebox[2in] {framed} text. 


Some 


framed 


text. 


There is a shorter related command with no optional arguments: 


\fbo x{(text)} 

The fancybox package provides some additional framing commands: 


\shadowbo x{(text)} 

Puts a shadow-style frame around its contents: 
Some \shadowbox{ framed} text. 
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\doublebo x{(text)} 

Puts a double-lined frame around its contents: 
Some \doublebox{framed} text. 

Some framed text. 


\ovalbox{(fexf}} 

Puts a thin-lined oval frame around its contents: 
Some \ovalbox{framed} text. 

Some [ framed J text. 


\Ovalbox{(fexf}} 


Puts a thick-Iined oval frame around its contents: 
Some \Ovalbox{framed} text. 


Some (framed) text. 


If you want a different frame effect, you will need to use a graphical 
package, such as pgf/tikz. 


Example: 

This example uses commands beyond the scope of this book, but gives you 
an idea of what's possible. 


\documentclass{scrartcl} 

\usepackage{tikz} 

\usetikzlibrary{shapes} 

\usetikzlibrary{decorations.pathmorphing} 
\begin{document} 

Some 

\begin{tikzpicture}[baseline=(n.base),décorâtion=bumps] 
\node[draw,ellipse,decorate] (n) {framed}; 
\end{tikzpicture} 
text. 

\end{document} 


Some 



text. 
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For further details, see the pgf documentation. 
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Related UK FAQ [18] topics: 

• Automatic sizing of minipage 

• Float(s) lost 

• Perhaps a missing \item? 


Chapter 5 
Structuring Vour Document 


Let's go back to the document we modified in Exercise 7. In this chapter we 
shall edit that document step by step until we hâve a fully-fledged document 
with title, abstract, table of contents, sections etc. 


5.1 Author and Title Information 

The term title page is used to indicate the author, title and date information 
that can appear either on the front cover by itself or along the top of the 
first page of text. In order to do this, you must first specify the information. 
Once this information has been specified it can then be displayed. 

The author, title and date are entered using the commands: 

\author {(author names )} 

\titl e{(title text)} 

\dat e{(document date)} 

The KOMA-Script classes also define: 

\titlehead {(Title heading)} 

\subject {(Subject)} 

\subtitle {(Subtitle)} 

\publishers{(Pu5!isher}} 

Ail these title-related commands only store information, they don't actu- 
ally display anything. These commands can be put in the preamble. With 
most classes, you will typically need to use at least \author and \title. 

Once you hâve used these commands, you can then display the infor¬ 
mation using the command: 

\maketitle 

This command should be placed where you want the title page to appear, 
which is normally at the start of the document environment. 

Note that if you don't use the \date command, the current date will 
be inserted. If you want no date to appear, you need to specify an empty 
argument: 

\date{} 

Multiple authors should be separated by the command \and. For example: 
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\author{A. Jones\\University of Somewhere \and 
B. Smith\\University of Somewhere Else} 


Within these titling fields, you can also use the command: 

\thanks{text} 

which produces a spécial type of footnote. For example: 

\title{A Great Project\thanks{funded by XYZ}} 

Note that the footnote marker produced using \thanks is considered to 
hâve zéro width, so if it occurs in the middle of a line, rather than the end, 
you will need to insert some extra space using M (backslash space). The 
argument of \thanks is a moving argument. 

Exercise 8 (Creating Title Pages) 

Try editing the document you modified in Exercise 7 to include title 
information. Modifications are illustrated in bold like this: 


\documentclass [ 12pt] {scrartcl} 

\usepackage{datetime} 

\title{A Simple Document} 

\author{Me} 

\begin{document} 

\maketitle 

This is a simple \LaTeX\,_,document . 

Here is the first paragraph. 

Here is the second paragraph\footnote{with a footnote}. 

As you can see it’s a rather short paragraph, but not 
as short as the previous one. This document was 
created on: \today\,_,at \currenttime . 

\begin{tabular}{lrr} 

& \multicolumn{2}{c}{\bfseries Expenditure}\\ 

& \multicolumn{l}{c}{Yearl} & \multicolumn{l}{c}{Year2}\\ 
\bfseries Travel & 100,000 & 110,000\\ 

\bfseries Equipment & 50,000 & 60,000 
\end{tabular} 
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4- Code 


You can download this document. 


5.2 Abstract 

The abstract environment is used to create an abstract for the document. The [FAQ: 1-column 
way in which the abstract is formatted dépends on the class file. The scrreprt abstract in 
class file will put the abstract on a page by itself, some class files will indent 2-column 
the abstract and some will typeset the abstract in italic. Note also that some document] 
class files (such as scrbook) don't hâve an abstract environment. Abstracts 
traditionally go at the start of the document after the title, so the abstract 
environment should go after the \maketitle command. 

Exercise 9 (Creating an Abstract) 

Try editing your document so that it has an abstract: Modifications are 
illustrated like this: 


\documentclass[12pt] {scrartcl} 

\usepackage{datetime} 

\title{A Simple Document} 

\author{Me} 

\begin{document} 

\maketitle 

\begin{abstract} 

A brief document to illustrate how to use \LaTeX. 
\end{abstract} 

This is a simple \LaTeX\,_,document . 

Here is the first paragraph. 

Here is the second paragraph\footnote{with a footnote}. 

As you can see it’s a rather short paragraph, but not 
as short as the previous one. This document was 
created on: \today\,_,at \currenttime . 

\begin{tabular} {lrr} 

& \multicolumn{2}{c}{\bfseries Expenditure}\\ 

& \multicolumn{l}{c}{Yearl} & \multicolumn{l}{c}{Year2}\\ 
\bfseries Travel & 100,000 & 110,00O\\ 
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\bfseries Equipment & 50,000 & 60,000 
\end{tabular} 


\end{document} 


You can download this document. 


5.3 Chapters, Sections, Subsections ... 

Chapters, sections, subsections etc can be inserted using the commands: 

\part [(short title)] {(title)} 

\chapter [(short title)] {(title)} 

\section [(short title)'] {(title)} 

\subsection {(short title)] {(title)} 

\subsubsection {(short title)] {(title)} 

\paragraph[ (short title)] {(title)} 

\subparagraph[(shorf title)] {(title)} 

Ail these commands hâve a moving argument (see Section 2.9), so frag¬ 
ile commands will need to be protected using \protect. The final two 
commands in the above list, \paragraph and \subparagraph, represent sub¬ 
subsubsections and subsubsubsubsections, although most class files typeset 
their arguments as unnumbered running titles. 

Note that the availability of these commands dépends on the class file 
you are using. For example, the scrartcl class file that we hâve been using is 
designed for articles, so the \chapter command is not defined in that class, 
whereas it is defined in the scrreprt and scrbook class files. 

Each of the commands above has a mandatory argument (title) and an 
optional argument (short title). The mandatory argument (title) is simply 
the title of the chapter/section/subsection etc. For example: 

\section{ Introduction} 

If you are using the scrartcl class file, the output will look like: 

I Introduction 

Note that you don't specify the section number as ETjrX does this automat- 
ically. This means that you can insert a new section or chapter or swap 
sections around or even change a section to a subsection etc, without hav- 
ing to worry about updating ail the section numbers. 

If you are using a class file that contains chapters as well as sections, the 
section number will dépend on the chapter. So, for example, the current 
section is the 3 rd section of chapter 5, so the section number is 5.3. (Note 
that if you are using a class file where the section number dépends on 
the chapter number, you must hâve a \chapter command before your first 


4- Code 


Définition 


[FAQ: How to 
create a 
\subsubsub- 
section] 


Input 

Output 


[FAQ: The style 
of section 
headings] 

[FAQ: Why are 
my sections 
numbered 0.1 ...?] 
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\section command, otherwise your section numbers will corne out as 0.1, 
0.2 etc.) 

Unnumbered chapters/sections etc are produced by placing an asterisk 
* after the command name. For example: 

\chapter*{Acknowledgements} 

You can switch to appendices using the command 

\appendix 

then continue using \chapter, \section etc. For example (using the scrreprt 
class file): 


\appendix 

\chapter {Dérivâtions} 
Some dérivations. 

\chapter {Tables} 

Some tables. 


Note: 

The KOMA-Script classes hâve another type of sectioning command: 
\minis ec{(heading}} 

This provides an unnumbered heading not associated with any of the struc¬ 
turing levels. For example, the above was produce using: 


\minisec{Note : } 

The KOMA-Script classes hâve another type of sectioning command: 


The next note below was produced using: 


\minisec{ Important Note:} 

If you want to change the font style used by headings, 
\emph{\bfseries do not} use font déclarations in the sectioning 
command arguments. 


Important Note: 

If you want to change the font style used by headings, do not use font 
déclarations in the sectioning command arguments. Don't do, for example: 


Input 

Définition 

[FAQ: 

Appendixes] 

t Input 


4- Input 

Définition 

f Input 

i Input 

t Input 

i Input 


\chapter{\itshape Introduction} 


X 
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The KOMA-Script classes provide the command: 

\addtokomafont {(element)}{(commands)} 

where ( element } is the name of a structuring element (no backslash) and 
( commands } is the list of font changing déclarations (see Table 4.6) to apply 
to that element style. For example, this book uses the commands: 


\addtokomafont{section}{\rmfamily\bfseries} 
\addtokomafont {minisec }{\rmfamily\bfseries\scshape} 


Exercise 10 (Creating Chapters, Sections etc) 

Let's try editing our document so that it now has chapters, sections and 
an appendix. Since the scrartcl class file doesn't hâve chapters, let's change 
to the scrreprt class. Changes from our previous document are shown like 
this. 


\documentclass [ 12pt] {scrreprt} 

\usepackage{datetime} 

\title{A Simple Document} 

\author{Me} 

\begin{document} 

\maketitle 

\begin{abstract} 

A brief document to illustrate how to use \LaTeX. 
\end{abstract} 

\chapter{ Introduction} 

\section{The First Section} 

This is a simple \LaTeX\,_,document . 

Here is the first paragraph. 

\section{The Next Section} 

Here is the second paragraph\footnote{with a footnote}. 
As you can see it’s a rather short paragraph, but not 
as short as the previous one. This document was 
created on: \today\,_,at \currenttime . 


Définition 


t Input 


i Input 


t Code 


\chapter{Another Chapter} 
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Here’s another very interesting chapter. 

We’re going to put a picture here later. 

\chapter*{Acknowledgements} 

I would like to acknowledge ail those 

very helpful people who hâve assisted me in my work. 

\appendix 

\chap ter{ Tab1es } 

We will turn this tabular environment into a table later. 

\begin{tabular}{lrr} 

& \multicolumn{2}{c}{\bfseries Expenditure}\\ 

& \multicolumn{l}{c}{Yearl} & \multicolumn{l}{c}{Year2}\\ 
\bfseries Travel & 100,000 & 110,00O\\ 

\bfseries Equipment & 50,000 & 60,000 
\end{tabular} 

\end{document} 


(You can download a copy of this file if you like, but I recommend that 
you try editing the file yourself to give you practice.) 


5.4 Creating a Table of Contents 

Once you hâve ail your sectioning commands, such as \chapter and \section, 
you can create a table of contents with the command 

\tableof contents 

This command should go where you want your table of contents to appear 
(usually after \maketitle). The KOMA-Script classes provide two options 
that govern the format of the table of contents: toc=graduated and toc= 
fiat. The first is the default and indents the different sectioning levels. The 
second doesn't use any indentation. 

Example: 

\documentclass [ 12pt,toc=flat]{scrreprt} 

You may recall from the previous section that the sectioning commands 
ail had an optional argument (short title). If your chapter or section title 
is particularly long, you can use (short title) to specify a shorter title that 
should go in the table of contents. 51 The longer title (given by the other 

51 and in the page header, depending on the page style. 


4- Code 


Définition 

[FAQ: The format 
of the Table of 
Contents, etc] 


Input 


[FAQ: My section 
title is too wide 
for the page 
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argument ( title }) will still appear in the section heading in the main part of 
the document. 

ETgX processes ail source code sequentially, so when it first encoun- 
ters the \tableofcontents command, it doesn't yet know anything about 
the chapters, sections etc. So the first time the document is ETjrXed the 
necessary information is written to the table of contents (. toc) file (see Sec¬ 
tion 2.4). The subséquent pass reads the information in from the .toc file, 
and generates the table of contents. You will therefore need to your 

document twice to make sure that the table of contents is up-to-date. 

Adding Extra Information 

The starred versions of the sectional commands (such as \chapter*) don't 
get added to the table of contents. It may be that you want to add it, in which 
case you need to use 


[FAQ: Numbers 
too large in table 
of contents, etc] 


\addcontentslin e{(foc)} {(section unit}} {(text)} Définition 

after the heading. The first argument (toc) is the file extension without the 
dot. As mentioned above, the table of contents file has the extension . toc, 
so the first argument should be toc (later in Chapter 7 (Floats), we'll be 
adding a list of figures and a list of tables, and those hâve file extensions 
. lof and . lot, respectively). The second argument ( section unit) is the 
name of the section unit. This is just the name of the relevant sectioning 
command without the backslash. The final argument (text) is the entry 
text. For example (using scrreprt class): 


\chapter*{Acknowledgments} 

\addcontentsline{toc}{chapter}{Acknowledgements} 

, 4- Input 


Exercise 11 (Creating a Table of Contents) 

Try modifying your document so that it has a table of contents. Modifi¬ 
cations from the previous exercise are illustrated like this: 


\documentclass [ 12pt]{scrreprt} 


■f Code 


\usepackage{datetime} 


\title{A Simple Document} 
\author{Me} 


\begin{document} 

\maketitle 


\tableofcontents 
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\begin{abstract} 

A brief document to illustrate how to use \LaTeX. 

\end{abstract} 

\chapter{ Introduction} 

\section{The First Section} 

This is a simple \LaTeX\,_,document . Here is the first paragraph. 
\section{The Next Section} 

Here is the second paragraph\footnote{with a footnote}. 

As you can see it’s a rather short paragraph, but not 
as short as the previous one. This document was 
created on: \today\,_,at \currenttime . 

\chapter{Another Chapter} 

Here’s another very interesting chapter. 

We’re going to put a picture here later. 

\chapter*{Acknowledgements} 

I would like to acknowledge ail those 
very helpful people who hâve assisted 
me in my work. 

\appendix 
\chapter {Tables} 

We will turn this tabular environment into a table later. 
\begin{tabular}{lrr} 

& \multicolumn{2}{c}{\bfseries Expenditure}\\ 

& \multicolumn{l}{c}{Yearl} & \multicolumn{l}{c}{Year2}\\ 
\bfseries Travel & 100,000 & 110,00O\\ 

\bfseries Equipment & 50,000 & 60,000 
\end{tabular} 


\end{document} 


i Code 


If your table of contents doesn't corne out right, try ETgXing it again. 
(Again, you can download this file.) 

You might want to try experimenting with the toc=flat class options to 
see what différence it makes: 
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\documentclass [ 12pt,toc=flat]{scrreprt} 


5.5 Cross-Referencing 

We hâve already seen that ETgX takes care of ali the numbering for the 
chapters etc, but what happens if you want to refer to a chapter or section? 
There's no point leaving ET^X to automatically generate the section numbers 
if you hâve to keep track of them ail, and change ail your cross-references 
every time you add a new section. Fortunately ETgX provides a way to 
generate the correct number. Ail you hâve to do is label the part of the 
document you want to reference, and then refer to this label when you 
want to cross-reference it. ETgX will then détermine the correct number 
that needs to be inserted at that point. 

The first part, labelling the place you want to reference, is done using 
the command: 

\label{(sfring}} 

The argument (string) should be a unique textual label. This label can be 
anything you like as long as it is unique, but it's a good idea to make it 
something obvious so that, firstly, you can remember the label when you 
want to use it, and secondly, when you read through your code at some 
later date, it's immediately apparent to you to which part of the document 
you are referring. People tend to hâve their own conventions for labelling. 
I usually start the label with two or three letters that signify what type of 
thing I'm labelling. For example, if I'm labelling a chapter I'H start with ch, 
if I'm labelling a section I'H start with sec. 

Examples: 

1. Labelling a chapter: 


\chapter{ Introduction} 
\label{ch: intro} 


2. Labelling a section: 


\section{Technical Details} 
\label{sec : details} 


Input 


[FAQ: Referring 
to labels in other 
documents] 


Définition 


t Input 


4- Input 


t Input 


i Input 
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Note that the \label command doesn't produce any text, it simply assigns 
a label. You can now refer to that object using the command: 

\ref{ (S tring)} Définition 


which will produce the relevant number. 


Example: 

See Section \ref{sec :results} for an analysis of the 
results. 

It is a typographical convention that you should never start a new line with 
a number. For example, if you hâve the text "Chapter 1" the "1" must be on 
the same line as the "Chapter". We can do this by using an unbreakable 
space, which will put a space but won't allow ETjrX to break the line at that 
point. This is done using the tilde (~) spécial character, so the example 
above should actually be: 

See Section~\ref {sec :results} for an analysis of the 
results. 

There is a similar command to reference the page number: 


Input 


Input 


\pageref { (string) } 


Définition 


Example: 


See Chapter~\ref{ch: def} on page~\pageref{ch: def} for a list of 
définitions. 

I_I 4- Input 

The label ch:def obviously needs to be defined somewhere: 


1 1 t Input 

\chapter {Definitions} 

\label{ch:def} 

I_I 4- Input 

In fact, I hâve done this in my source code for Chapter 2 (Some Définitions) 
of this document, so the above example would look like: 

See Chapter 2 on page 7 for a list of définitions. Output 

It's not just chapters and sections that you can reference, most of the [FAQ: Referring 

numbers that ET^X automatically generates can be cross-referenced. *° things by their 

name] 

Example: 

The source code for footnote 5.1 on page 85 is: 


\footnote{\label{ftn:header}and in the page header, depending on 
the page style} 


and it was referenced above using: 







Chapter 5 Structuring Your Document 


90 


The source code for footnote~\ref{ftn:header} on 
page~\pageref{ftn:header} is: 


The varioref package provides a more convenient way of doing this using 
the command: 

\vref{(iabei}} Définition 

This is like \ref but also adds information about the location, such as "on 
page (n)" or "on the following page", if the corresponding \label occurs on 


a different page, so the above example can be changed to: 

The source code for footnote~\vref{ftn:header} is: 
which still produces 

The source code for footnote 5.1 on page 85 is: Output 

Compare with a reference to one of the labels in the next example: 

See step~\vref{itm:edit}. nput 

which produces: 

See step 1 on the following page. Output 

Caveat: 


You can run into trouble if the \vref command occurs on a page break. 
When it tries to insert the location information, such as "on the next page", 
the information is no longer correct. This can cause an "Infinité loop" error. 
When this happens, either edit your paragraph so the reference no longer 
falls on the page break or use \ref instead of \vref for that instance. 

Another Example: 

The enumerate environment described in Section 4.4.2 automatically numbers 
the items within an ordered list, so it's possible to label list items. Recall the 
numbered list of instructions at the start of Chapter 3 (From Source Code 
to Typeset Output). Flere's the code: 


1 î Input 

\begin{ enumerate} 

\item\label{itm: edit} Write or edit the source code. 

\item Pass the source code to the \texttt{latex} or \texttt{pdflatex} 
application (‘ ‘ \LaTeX\,_,the document’’). 

\begin{itemize} 

\item If there are any error messages, 
return to Step~\ref{itm: edit}. 


\item If there are no error messages, a PDF file 





Chapter 5 Structuring Your Document 


91 


is created, go to Step~\ref{itm: view}. 
\end{itemize} 

\item\label{itm: view} View the PDF file to check the resuit. 
\end{enumerate} 

Output: 


1. Write or edit the source code. 

2. Pass the source code to the latex or pdflatex application ("ETeX the 
document"). 

• If there are any error messages, return to Step 1. 

• If there are no error messages, a PDF file is created, go to Step 3. 

3. View the PDF file to check the resuit. 


The \ref and \pageref commands may corne before or after the corre- 
sponding \label command. As with the table of contents, ETeX first writes 
out ail the cross-referencing information to another file (the auxiliary (. aux) 
file, see Section 2.4) and then reads it in the next time, so you will need to 
EI^X your document twice to get everything up-to-date. 

If the references aren't up-to-date, you will see the following message at 
the end of the ETeX run: 

LaTeX Warning: Label(s) may hâve changed. 

Rerun to get cross-references right. 

The following warning 

LaTeX Warning: There were undefined references. 

means that ETeX found a reference to a label that does not appear in the 
auxiliary file. This could mean that it's a new label, and the warning will go 
away the next time you EI^X your document, or it could mean that either 
you've forgotten to define your label with the \label command, or you've 
simply misspelt the label. The undefined references will show up as two 
question marks ?? in the output file. 

Very occasionally, if you hâve cross-references and a table of contents, 
you might hâve to ET^X your document three times to get everything up to 
date. Just check to see if the Label (s) may hâve changed warning appears. 

If you find it inconvénient having to remember to click the typeset button 
twice, you can use latexmk. This will run ETeX the required number of 
times to ensure the document is up-to-date. To do this in TeXWorks, change 
the drop-down menu to "LaTeXmk", as illustrated in Figure 5.1. Note that 


4. Input 


î Output 


4 Output 


[FAQ: "Rerun" 
messages won't 
go away] 
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Figure 5.1 Selecting LaTeXmk in TeXWorks 
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latexmk is a Perl script, so you need to make sure you hâve péri installed 
(see Section 2.20). 

If latexmk isn't listed in the drop-down menu, you can add it via Edit—> 
Preferences. This opens the dialog box shown in Figure 5.2. You can add a 
new tool as follows: 

1. To the right of the box labelled "Processing Tools" there is a button 
marked with a plus (+) sign. Click on it to open the tool configuration 
dialog, shown in Figure 5.3. 

2. Fill in the name "LaTeXmk" in the box labelled "Name" and either type 
in the location of latexmk in the box labelled "Program" or use the 
"Browse" button to locate it on your filing System. (See Figure 5.4.) This 
will vary depending on your operating System and TgX-distribution, but 
it will probably be in a subdirectory (folder) called bin somewhere in 
the TgX-distribution tree. 

3. There are lots of options that can be passed to latexmk, but if you want 
to produce PDF output you need to add -pdf as an argument. This is 
done by clicking on the button marked with a plus to the right of the 
"Arguments" box and type -pdf, as shown in Figure 5.5. 

4. Another argument needs to be added that spécifiés the basename of 
the ETpX file. This is done by again clicking on the plus button and 
typing $basename, as shown in Figure 5.6 . 

5. Click on "OK" to close the Tool Configuration dialog. 

6. If you want to set latexmk to be your default processing tool, you can 
select it from the drop-down list labelled "Default". 

7. Click "OK" when you're done. 

Exercise 12 (Cross-Referencing) 

Try modifying your code so that it has cross-references. Again, changes 
made from the previous exercise are illustrated like this: 


t Code 

\documentclass [ 12pt]{scrreprt} 

\usepackage{datetime} 

\title{A Simple Document} 

\author{Me} 

\begin{document} 


\maketitle 
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Figure 5.2 TeXWorks Preferences 



0 View PDF after running 


Cancel 


OK 


Figure 5.3 Tool Configuration Dialog 
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Figure 5.4 Tool Configuration Dialog: set the name and program location 



Figure 5.5 Tool Configuration Dialog: adding -pdf argument 
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Figure 5.6 Tool Configuration Dialog: adding îbasename argument 


\tableof contents 
\begin{abstract} 

A brief document to illustrate how to use \LaTeX. 

\end{abstract} 

\chapter{ Introduction} 

\label{ch :intro} 

\section{The First Section} 

This is a simple \LaTeX\,_,document . Here is the first paragraph. 

The next chapter is Chapter~\ref{ch: another} 
and is on page~\pageref{ch :another}. 

The next section is Section~\ref{sec:next} . 

\section{The Next Section} 

\label{sec:next} 

Here is the second paragraph\footnote{with a footnote}. 

As you can see it’s a rather short paragraph, but not 
as short as the previous one. This document was 
created on: \today\,_,at \currenttime . 

\chapter{Another Chapter} 

\label{ch :another} 

Here’s another very interesting chapter. 

We’re going to put a picture here later. 
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See Chapter~\ref{ch:intro} for an 
introduction. 

\chapter*{Acknowledgements} 

I would like to acknowledge ail those 
very helpful people who hâve assisted 
me in my work. 

\appendix 
\chapter {Tables} 

We will turn this tabular environment into a table later. 
\begin{tabular}{lrr} 

& \multicolumn{2}{c}{\bfseries Expenditure}\\ 

& \multicolumn{l}{c}{Yearl} & \multicolumn{l}{c}{Year2}\\ 
\bfseries Travel & 100,000 & 110,00O\\ 

\bfseries Equipment & 50,000 & 60,000 
\end{tabular} 

\end{document} 


(You can download a copy of this file.) 


5.6 Creating a Bibliographe 

If you hâve a large number of citations in your document, it's best to use 
an external bibliographie application, such as bibtex or biber. However, 
that is beyond the scope of this book (see, instead, A Guide to BTp;X [7], The 
BTp;X Companion [3] or Using BTpX to Write a PhD Thesis [13]). Therefore 
this section just gives a brief explanation of the thebibliography environment, 
which is usually automatically generated using bibtex or biber. 

\begin{thebibliography} {(widest tag )} 

This environment is very similar to the list making environments described 
in Section 4.4, but instead of \item use 

\bibitem[(fag)] {(key)} 

where (key) is a unique keyword that identifies this item. Your keyword can 
be anything you like, but as with \label I recommend that you use a short 
mémorable keyword. I tend to use the first author's surname followed by 
the year of publication. 


4- Code 


[FAQ: Creating a 
BibTeX 

bibliography file] 


Définition 


Définition 
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The bibliography heading dépends on the class file you are using. Most 
of the article-style classes, such as scrreprt, use \refname (which produces 
"References") in an unnumbered section, whereas the report and book- 
styles, such as scrreprt and scrbook, use \bibname (which produces "Bibliogra¬ 
phy") in an unnumbered chapter. See Table 8.1 for the list of the common 
textual label commands. 

Most class files don't automatically add the bibliography to the table of 
contents. The KOMA-Script classes provide the bibliography option. This 
can be bibliography=totoc (an unnumbered unit added to the table of con¬ 
tents), for example, 

\documentclass [bibliography=totoc]{scrreprt} 

or bibliography=totocnumbered (a numbered unit added to the table of 
contents), for example, 

\documentclass [bibliography=totocnumbered]{scrreprt} 

If you're not using one of the KOMA-Script classes, consult the documen¬ 
tation for your class to see if there is an équivalent option. Failing that, you 
can use \addcontentsline (described in Section 5.4). For example (using a 
class that defines chapters): 


\addcontent siine{ toc }{ chapter }{\bibname} 
\begin{bibliography}{l} 


Example: 

(This example uses the command \LaTeXe which produces the E r I^X2e logo. 
This indicates the current version of rather than the old 2.09 ver¬ 

sion.) 52 The class style in use is scrbook, so the title is given by \bibname 
("Bibliography"). 


\begin{thebibliography}{3} 

\bibitem{lamport94} ‘ ‘\LaTeX: a document préparation System’ ’ , 
Leslie Lamport, 2nd édition (updated for \LaTeXe) , Addison-Wesley 
(1994). 

\bibitem{kopka95} ‘ ‘A Guide to \LaTeX: document préparation for 
beginners and advanced users ’’ , Helmut Kopka and Patrick W. Daly, 
Addison-Wesley (1995). 

\bibitem{goossens94} ‘‘The \LaTeX\,_,Companion’ ’ , Michel Goossens, 
Frank Mittelbach and Alexander Samarin, Addison-Wesley, (1994). 

\end{thebibliography} 


52 If a friend or colleague gives you a file containing \docuraentstyle instead of 
\documentclass they are nearly 20 years ouf of date. 


Input 

Input 

î Input 
4, Input 


■f Input 


4, Input 
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i i 

Bibliographe 

[1] "ETjrX: a document préparation System", Leslie Lamport, 2nd édition (up- 
dated for ETp;X2 £ ), Addison-Wesley (1994). 

[2] "A Guide to ETj;X: document préparation for beginners and advanced 
users", Helmut Kopka and Patrick W. Daly, Addison-Wesley (1995). 

[3] "The ETp;X Companion", Michel Goossens, Frank Mittelbach and Alexan¬ 
der Samarin, Addison-Wesley, (1994). 


You can cite an item in your bibliography with the command 
\cite[(fexf)] {(key list )} 

Example: 


For more information about writing bibliographies see 
Goossens \emph{et al. }~\cite{goossens94} . 


Output: 

For more information about writing bibliographies see Goossens et 
al. [3]. 

If you want to cite multiple works, use a comma-separated list: 


For more information about writing bibliographies 
see~\cite{kopka95 ,goossens94}. 


Output: 

For more information about writing bibliographies see [2,3]. 

The optional argument (text) to the \cite command can be used to add 
text to the citation. 

Example: 


For more information about writing bibliographies see 
Goossens \emph{et al. }~\cite [Chapter~13]{goossens94}. 


t Output 


4- Output 


Définition 


t Input 


i Input 


Output 


t Input 


4- Input 


Output 


t Input 


4- Input 


Output: 
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For more information about writing bibliographies see Goossens et al. [3, 
Chapter 13]. 


The thebibliography environment has a mandatory argument: 
\begin{thebibliography } {(widest tag )} 

The argument (widest tag } is the widest tag in the list of entries. This 
helps ETgX to align the references correctly. In the example above, the 
tags appeared as: [1], [2] and [3], and [3] is the widest so that was used as 
the argument. These tags can be changed from the default numbers to 
something else using the optional argument to the \bibitem command. 

Example (Textual Tags): 

This example uses the optional argument of \bibitem to use textual rather 
than numerical tags. The widest tag is [Goossens 1994] so that is chosen to 
be the argument of the thebibliography environment: 


\begin{ thebibliography}{Goossens 1994} 

\bibitem [Lamport 1994]{lamport94} ‘‘\LaTeX\ : a document 
préparation System’’, Leslie Lamport, 2nd édition (updated for 
\LaTeXe) , Addison-Wesley (1994). 

\bibitem[Kopka 1995]{kopka95} ‘‘A Guide to \LaTeX: document 
préparation for beginners and advanced users’’, Helmut Kopka and 
Patrick W. Daly, Addison-Wesley (1995). 

\bibitem[Goossens 1994]{goossens94} ‘‘The XLaTeXX^Companion’ ’ , 
Michel Goossens, Frank Mittelbach and Alexander Samarin, 
Addison-Wesley, (1994). 

\end{ thebibliography} 


i i 

Bibliographe 

[Lamport 1994] "ET^X : a document préparation System", Leslie Lamport, 
2nd édition (updated for E r I^X2e), Addison-Wesley (1994). 

[Kopka 1995] "A Guide to KTgX: document préparation for beginners 
and advanced users", Helmut Kopka and Patrick W. Daly, 
Addison-Wesley (1995). 

[Goossens 1994] "The ET^X Companion", Michel Goossens, Frank Mittel¬ 
bach and Alexander Samarin, Addison-Wesley, (1994). 


t Output 


4- Output 
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i Input 


t Output 
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Exercise 13 (Creating a Bibliographe) 

Try adding the following chapter to your document: 


\chapter{Recommended Reading} 

For a basic introduction to \LaTeX\,_,see Lamport~\cite{lamport94} . 
For more detailed information about XLaTeXX^and associated 
applications, consult Kopka and Daly~\cite{kopka95} or Goossens 
\emph{et al}~\cite{goossens94} . 


and also add the bibliography shown above to the end of your document. 
You can download or view the solution, but hâve a go by yourself first. 
Remember that, as before, you will need to ETgX the document twice to 
get the references up-to-date, unless you're using latexmk (as described in 
Section 5.5) in which case it will be done automatically. 


5.7 Page Styles and Page Numbering 

You may hâve noticed that the documents you hâve created hâve ail had 
their page numbers automatically inserted at the foot of most of the pages. 
If you hâve created the document that has gradually been modified over 
the previous few sections, you may hâve noticed that the title page has no 
header or footer, the table of contents starts on page 1, the abstract page 
has no page number, and the pages after the abstract start on page 1 and 
continue incrementally onwards from that point. Ali the page numbers are 
Arabie numerals. This can be changed using the command: 

\pagenumber ing { (style) } 

where (style) can be one of: 

arabic Arabie numerals (1, 2, 3, ...) 

roman Lower case Roman numerals (i, ii, iii, ... ) 

Roman Upper case Roman numerals (I, II, III, ... ) 

alph Lower case alphabetical characters (a, b, c, ... ) 

Alph Upper case alphabetical characters (A, B, C, ... ) 

Traditionally, the front matter (table of contents, list of figures etc) should 
hâve lower case Roman numéral page numbering, while the main matter 
should be in Arabic numerals. 
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Example: 


\author{Me} 

\title{A Simple Document} 
\maketitle 

\pagenumbering {roman} 
\tableof contents 

\begin{abstract} 

This is the abstract. 
\end{abstract} 

\pagenumbering{arabic} 
\chapter{ Introduction} 


The scrbook class provides: 

\frontmatter 

which switches to lower case Roman numéral page numbering, and 
\mainmatter 

which switches to Arabie numéral page numbering. These two déclarations 
also change the way the sectioning units, such as \chapter and \section, 
appear. The former, \frontmatter, suppresses the numbering (regardless 
of whether or not you've used the starred version of the sectioning com- 
mands). The latter, \mainmatter, switches the numbering back on (unless 
otherwise suppressed by using the starred sectioning commands). In addi¬ 
tion, scrbook provides 

\backmatter 

which doesn't affect the page numbering but, like \frontmatter, suppresses 
the sectional unit numbering. 

Note: 

The abstract environment isn't defined by the scrbook class, as a book sum- 
mary is usually incorporated into an introductory section. 

Example: 


\documentclass [ 12pt]{scrbook} 

\title{A Simple Document} 
\author{Me} 
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\begin{document} 

\maketitle 

\frontmatter 
\tableof contents 

\chapter{Summary} 

A brief document to 
illustrate how to use \LaTeX. 

\mainmatter 

\chapter{ Introduction} 
\label{ch: intro} 

\end{document} 


The headers and footers can be changed using the command 
\pagestyl e{(style)} 

Individual pages can be changed using 
\thispagestyl e{(style)} 

Standard styles are: 

empty No header or footer. 

plain Header empty, page number in footer. 

headings Header contains page number and various information, footer 
empty. 

myheadings Header specified by user, footer empty. 

If the myheadings style is used, the header information can be specified 
using: 

\markboth{ (left head}}{(right head)} 

if the twoside option has been passed to the class file (default for scrbook), 
or 


\markright {(right head}} 

if the oneside option has been passed to the class file (default for scrartcl and 
scrreprt). 

The scrreprt class file uses the empty style for the title and abstract pages 
and plain for the first page of each new chapter. By default the remain- 
ing pages are also plain, but these can be changed using the \pagestyle 
command. The scrbook class defaults to the headings style instead of plain. 
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The KOMA-Script bundle provides a way to define new page styles, but 
that's beyond the scope of this introductory tutorial. See the KOMA-Script 
documentation for further details if you are interested. 

This book mostly uses the headings page style and the scrbook class with 
the oneside option, so there is no différence between odd and even page 
headers, whereas the paperback version uses the twoside option, so the 
odd pages display the chapter number and title and the even pages display 
the current section header and title. The on-screen PDF version of this 
book uses a page style I defined myself that incorporâtes a navigation bar 
in the footer. 

Exercise 14 (Page Styles and Page Numbering) 

Try modifying your code so that it uses the scrbook class, \frontmatter 
and \mainmatter. Replace the abstract environment with an unnumbered 
chapter, as shown below. Again, changes made from the previous document 
are illustrated like this: 


\documentclass [ 12pt] {scrbook} 
\usepackage{datetime} 

\pagestyle{headings} 

\title{A Simple Document} 

\author{Me} 

\begin{document} 

\maketitle 

\frontmatter 

\tableof contents 

\chapter { Summary} 

A brief document to 
illustrate how to use \LaTeX. 

\mainmatter 

\chapter{ Introduction} 

\label{ch: intro} 

\section{The First Section} 

This is a simple XLaTeXMdocument . 

Here is the first paragraph. 

The next chapter is Chapter~\ref{ch: another} 
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and is on page~\pageref{ch: another}. 

The next section is Section~\ref{sec :next}. 

% Rest of document unchanged but 
% omitted for brevity. 

\end{document} 


(You can download or view the edited document.) 


5.8 Multi-Lingual Support: using the babel 
package 

You may hâve noticed that the \tableofcontents and \chapter commands 
hâve produced English words like "Contents" and "Chapter". If you are 
writing in another language, this is not appropriate. In this case, you can 
use the babel package, and specify which language you will be using, either 
as an option to the babel package, or as an option to the class file. If you are 
writing in more than one language, list ali the languages that you will be 
using where the last named language is the default language. For example: 

\usepackage [english,french]{babel} 

or 

\documentclass [english,french]{scrreprt} 

\usepackage {babel} 

You can then switch between the named languages either using the décla¬ 
ration: 

\selectlanguage {(language)} 
or the otherlanguage environment: 

\begin{otherlanguage}{ (language)} 

These will affect ail translations, including the date format and predefined 
names like "Chapter". This also changes the hyphenation patterns. (See 
Section 2.14.) 

If you only want to set a short section of text in a different language, 
without affecting the date format or predefined names, then you can either 
use the command: 

\f or e i gnl anguag e { ( language ) } { ( text) } 

or the starred version of the otherlanguage environment: 

\begin{otherlanguage*} {(language)} 
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You can test to see if a given language is currently selected using: 
\iflanguage{(langruage)}{(frue text)}{(false text )} 

Example: 


\documentclass[UKenglish,USenglish, french]{scrartcl} 

% french is the last named option, so that’s the current language 

\usepackage [Tl] {fontenc} 

\usepackage [utf8]{inputenc} 

\usepackage {babel} 

\begin{document} 

Ce texte est en fran\c{c}ais. La date aujourd’hui est: \today. 
\selectlanguage{USenglish} 

This text is in US English. Today’s date is: \today. 
\selectlanguage{UKenglish} 

This text is in UK English. Today’s date is: \today. 
\end{document} 


Resuit: 


Ce texte est en français. La date aujourd'hui est : 25 septembre 2012. 
This text is in US English. Today's date is: September 25, 2012. 

This text is in UK English. Today's date is: 25th September 2012. 


Note: 

If you are using the french option, the colon character ( : ) is made active 
(that is, it's turned into a spécial character) so if you are writing in French 
it's best not to use a colon in labels (so where I've used, say, ch:def you may 
need to change the colon to something else). 
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Chapter 6 

The graphicx Package 


It is possible to generate images using ETgX commands (See the pgf/tikz 
package or The BT^K Graphics Companion [5]) however most people find 
it easier to create a picture in some other application, and include that file 
into their ETp;X document. 

PDFETgX can insert PDF, PNG and JPG image files into your docu¬ 
ment. If your image file is in a different format, you may be able to 
find an application to convert it. Modem TgX-distributions can automati- 
cally convert EPS files to PDF during the ET^X run using the Perl script 
epstopdf. If your TgX-distribution doesn't support this, you can convert 
your EPS file using epstopdf explicitly. For example, if you hâve an EPS 
image called, say, sample-image.eps, you can convert it to a PDF image 
called sample-image.pdf, by using the following command in a terminal or 
command prompt: 

epstopdf sample-image.eps 

or (full path name may be required) 

péri epstopdf sample-image.eps 

To insert an image file into your document, you first need to specify 
that you want to use the graphicx package. So the following must go in the 
preamble: 

\usepackage {graphicx} 

The image can then be included in your document using the command 
\includegraphics[(J?ey-val options}] {( filename }} 

where ( filename } is the name of your image file without the file extension, 
and ( key-val options) is a comma-separated list of options that can be used 
to change the way the image is displayed. Note that if you hâve an image 
where the file name contain spaces or multiple dots, you need to use the 
grffile package: 

\usepackage{graphicx ,grffile} 

Example: 

Suppose you had a file called shapes.pdf, then to include it in your docu¬ 
ment you would do: 

\includegraphics{shapes} 

which would produce: 
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You can specify a full or relative pathname, but you must use a forward 
slash / as the directory divider, even if you are using Windows. For example: 

\includegraphics{pictures/shapes} 

means the file pictures/shapes.pdf on Unix-type Systems, and it means 
the file pictures\shapes.pdf on Windows. 61 This is mainly because the 
backslash character is a ETgX spécial character indicating a command, but 
it also helps portability between platforms. 

You can specify the order of the file types to look for with the command 

\DeclareGraphicsExtensions {(ext-list)} 

where ( ext-list } is a comma-separated list of extensions. For example, you 
might want to search first for PDF files, then for PNG files, then for JPG 
files and finally for EPS files: 

\DeclareGraphicsExtensionsf.pdf, .png,.jpg,.eps} 

The default for PDFETpX is: 

.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG, 

.JBIG2,.JB2,.eps 

The optional argument ( key-val options) should be a comma-separated 
list of ( key)=(value } pairs. Common options are: 


angle = (x) 


rotate the image by x° anticlockwise. 


width= (length) 
height =(length) 


scale the image so that the width is (length). (Remem- 
ber to specify the units.) 

scale the image so that the height is (length). (Remem- 
ber to specify the units.) 


scale = (value) Scale the image by (value) 

trim=(l) (b) (r) (t) Spécifiés the amount to remove from each side. For 

example 


\includegraphics [trim=l 2 3 4]{shapes} 


crops the image by lbp from the left, 2bp from the bot- 
tom, 3bp from the right and 4bp from the top. (Recall 
the bp unit from Table 2.1.) 

61 Or shapes.png or shapes.jpg or shapes.eps. The example assumes a PDF image file. 
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draft Don't actually print the image, just draw a box of the 

same size and print the filename inside it. 


Example: 

This example first rotâtes the image by 45° anticlockwise, then scales it so 
that the width is 1 inch. 

\includegraphics [angle=45,width=lin]{shapes} 

* 

Note that this isn't the same as scaling and then rotating: 
\includegraphics[width=lin, angle=45]{shapes} 

* 

You can also scale an image relative to the text area using the length 
registers \textwidth and \textheight. For example, to scale a portrait 
image so that its height is three-quarters of the text area height, you can 
do: 

\includegraphics [height=®. 75\textheight] {shapes} 

or to scale a landscape image so that its width is half the text area width, 
you can do: 

\includegraphics [height=®. 5\textwidth] {shapes} 

Note: 

The \includegraphics command is another form of box (see Section 4.7), 
and can be used in the middle of a line of text, just like the tabular environ¬ 
ment. See Section 7.1 to find out how to put the image in a figure with a 
caption. 

Example: 

Recall the ex unit of measure from Table 2.1. This can be used to scale an 
image relative to the font size: 


An image can be inserted into a line of text like this: 
\includegraphics [height=2ex]{shapes} 
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6.1 Graphical Transformations 

The graphicx package also provides commands to rotate, resize, reflect and 
scale text. They are as follows: 

\rotatebo x[(opfion list }] {(angle)}{(text)} 

Rotâtes (text) by (angle) (degrees anti-clockwise by default). The optional 
argument (option list) is a comma-separated list of any of the following 
options: 

• units =(number) 

The number of units in one full anti-clockwise rotation. So units=-36® 
means that (angle) spécifiés degrees clockwise whereas units=6.283185 
means that (angle) is in radians. 

• origin= (label) 

The point of rotation. The value (label) may contain one from either 
or both of the two lists: lrc (left, right, centre) and tbB (top, bottom, 
baseline). Alternatively the origin may be specified using the following 
two keys: 

• x=(dimen) 

• y=(dimen) 

Example: 


base line 

\rotatebox{45}{Some text} 

\rotatebox[units=-360] {45}{Some text} 
\rotatebox[units=-36® ,origin=rB]{45}{Some text} 
\rotatebox[x=3em,y=3em] {45}{Some text} 
base line 


base line °o 










& 




% 


O . 




% 


O 














& base line 


\scalebox{(h scale)} [(v scale)] {(text)} 

Scales (text) by (h scale) in both directions if (v scale) omitted, otherwise 
scales (text) by (h scale) horizontally and (y scale) vertically. 
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Example: 

\scalebox{® .8}{Some text} 

Some text 

Compare with: 

\scalebox{® . 8}[1 . 2] {Some text} 

Some text 

\reflectbo x{(text)} 

Reflects (text) (équivalent to \scalebox{-l} [1] {(text)}). 

Example: 

\reflectbox{Some text} 
txet omoS 

\resizebox{(h length)}{(v length)}{(text }} 

Scales (text) so that it is (h length) wide and (v length) high. To preserve 
the aspect ratio, use ! instead of one of the dimensions. 

Example: 


\resizebox{12mm}{lcm}{Some text} 
\resizebox{! }{lcm}{Some text} 


tltïlSome text 


6.2 Package Options 

The graphicx package can hâve the following options passed to it: 

draft Don't actually display the images, just print the filename in a 

box of the correct size. This is useful if you want to print out 
a draft copy of a document to check the text rather than the 
images. 

final Opposite of draft (default). 

hiderotate Don't show rotated text. 
hidescale Don't show scaled text. 

Remember that relevant options passed to the class file also affect pack¬ 
ages. 
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Example (Draft Mode): 

Draft mode helps to speed up compilation of a large document when you 
are editing the text. In the preamble: 

\usepackage [draft]{graphicx} 

or 


\documentclass [draft]{scrbook} 
\usepackage {graphicx} 


Later in the document: 

\includegraphics[width=lin, angle=45]{pictures/shapes} 
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Exercise 15 (Using the graphicx Package) 

Download the image file shapes. pdf from http : //www. dickimaw-books. 
com/latex/novices/html/exercises/ (or create your own image), and in- 
clude it into your document. (You can download or view an example solu¬ 
tion.) 


For more information on the graphicx package see The BTgX Graphics 
Companion [5] or the graphicx documentation. 

Related UK FAQ [18] topics: 

• FIow to import graphies into (La)TeX documents 

• Imported graphies in PDFLaTeX 

• Imported graphies in dvips 

• Imported graphies in dvipdfm 

• Importing graphies from "somewhere else" 

• Portable imported graphies 

• Repeated graphies in a document 

• Limit the width of imported graphies 
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• Top-aligning imported graphies 

• Labelling graphies 

• Graphics division by zéro 


Chapter 7 
Floats 


Figures and tables are referred to as "floats" because they are floated to the 
nearest location. This prevents ugly large spaces appearing on the page 
if there isn't enough room for the figure or table before the page break. 
Floats hâve a caption and associated number. It is customary for captions 
to appear at the bottom of figures but at the top of tables [17, 11]. 

For both figures and tables, the caption is generated using the command: 

\caption [(short caption }] {( text }} 

Note that the \caption command has a moving argument, so fragile com- 
mands will need to be protected using \protect. The optional argument 
(short caption) is used to provide an alternative shorter caption for the list 
of figures or list of tables, akin to the optional argument to the sectioning 
commands described in Section 5.3. 

Note: 

Although the \caption command can hâve an optional short title, in general, 
captions should be brief. They should not contain lots of description or 
background detail [17]. That type of information should be placed in the 
main text not the caption. 

Positioning: 

Both the figure and table environments hâve an optional argument (placement 
specifiers), which indicates permissible locations for the float. This may be 
a combination of h ("here"), t (top), b (bottom) and p (page of floats.) Note 
that this only gives a general guideline as to where the float will end up. 
The final location is governed by other factors, such as space left on the 
page and the proportion of text to floats on the page. If you omit one or 
more of the placement specifiers, then you are prohibiting the float from 
being placed in that location. A common mistake is to do 

\begin{figure} [h] 

which says "I want the figure here and it can't go anywhere else!" If the 
figure can't be placed exactly here (for example, there may not be enough 
room on the page), then you hâve given it no alternative location, which 
can resuit in this and ail subséquent figures being dumped at the end of the 
chapter or document, or can resuit in a fatal error when running ETjrX. You 
may be able to manage with only one of the other options, for example, 

\begin{figure} [t] 
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(In fact, modem TgX distributions now replace [h] with [t] if the float can't 
be placed.) However, if you hâve a large number of floats it is advisable to 
provide as many options as possible: 

\begin{figure} [htbp] 

Similarly for tables. 

If you are absolutely adamant that an image must go "right here", then 
it's not a float, and you shouldn't be using the figure environment. It's just 
a horizontal box, like the example on page 109. Similarly for tabulated 
material. 

It's worth bearing in mind what the Oxford Style Manual [11] has to say: 

''Text must not be read into it so as to give [the figure] an ex- 
plicit and fixed introduction, for example 'in the following figure': 
the final placement is determined by page breaks, which cannot 
be anticipated before setting, and this makes rewording the text 
necessary if the illustration does not fit the make-up of the page." 

Turabian [17] gives the same advice (and réitérâtes it for figures): 

"Ail text references to a table should be by a number, not by an 
introductory phrase such as 'in the following table'." 


7.1 Figures 

Figures are created using the figure environment. 

\begin{figure} [( placement speciflers )] 

This environment may contain one or more captions (specified, as described 
above, with the \caption command) but page breaks are not allowed in 
the contents of a figure environment. The optional argument (placement 
speciflers } is as described above. 

Recall from Chapter 6 (The graphicx Package) that we can include an 
image in our document with the command \includegraphics defined in 
the graphicx package. We can put our shapes.pdf image into a figure as 
follows: 


\begin{figure} [htbp] 

\includegraphics{shapes} 
\caption{Some Shapes} 
\end{figure} 


So far so good, but our picture needs to be centred. This can be done using 
the \centering déclaration mentioned in Section 2.12: 


\begin{figure} [htbp] 
\centering 
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\includegraphics{shapes} 
\caption{Some Shapes} 
\end{figure} 


The \caption command generates a number, just like \section, so we can 
cross-reference it with \ref and \label. First, let's label the figure: 


\begin{figure} [htbp] 
\centering 

\includegraphics{ shapes} 
\caption{Some Shapes} 
\label{fig :shapes} 
\end{figure} 


Now we can reference it: 

Figure~\ref{fig :shapes} shows some shapes. 

(As before we use ~ to make an unbreakable space.) This produces the 
following output in the text: 

Figure 7.1 shows some shapes. Output 

and produces Figure 7.1. 



Figure 7.1 Some Shapes 


Important Note: 

If you want to change the caption font, don't do, e.g.: 

\caption{\bfseries Some Shapes} 

Recall \addtokomafont from Section 5.3. This can also be used to change 
the fonts used by the caption. 

✓ 


\addtokomafont {caption} {\bfsériés} 

Similarly for the caption label. For example: 
\addtokomafont{captionlabel}{\scshape} 
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List of Figures 

Just as we were able to generate a table of contents using \tableofcontents, 
we can also generate a list of figures using the command 

\listoffigures 

This créâtes a file with the extension . lof (see Section 2.4). As with 
\tableofcontents you will need to ETjrX your document twice to get the 
list of figures up-to-date, unless you're using latexmk (as described in Sec¬ 
tion 5.5) in which case it will be done automatically. 

Exercise 16 (Creating Figures) 

If you did Exercise 15, you should hâve a document with an image in 
it. You now need to put this image into a figure environment. Remember 
to centre the image, and give the figure a caption. Next, try labelling the 
figure and referencing it in the text. You could also put in a list of figures 
after the table of contents. You can download or view an example. 


7.1.1 Side-By-Side Figures 

Recall at the start of Section 7.1, I mentioned that the figure environment 
may contain one or more captions. In most cases, you'll just hâve a single 
caption per figure environment, but sometimes you may want to hâve two 
figures side-by-side, in which case you'll need two captions within the same 
figure environment in order to keep the figures together. 

To do this, we can use the minipage environment, which was covered in 
Section 4.7. Recall that the minipage environment créâtes a horizontal box, 
which means that two mini-pages can be placed side-by-side on the same 
line. Ail you need to do now, is place one image and caption in one mini¬ 
page, and the other image and caption in the neighbouring mini-page. (Do 
you remember what effect is obtained by placing a percent symbol at the 
end of a line?) 


\begin{figure} [htbp] 
\begin{minipage}{0 . 5\linewidth} 
\centering 

\includegraphics{circle} 
\caption{A Circle} 

\label{fig :circle} 
\end{minipage}% 

\begin{minipage}{0 . 5\linewidth} 
\centering 

\includegraphics {rectangle} 
\caption{A Rectangle} 
\label{fig : rectangle} 
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\end{minipage} 

\end{figure} 


The above code produces Figures 7.2 and 7.3. Note that each mini-page uses 
\centering to centre its contents, and the label is also placed in the same 
mini-page, after the \caption command. If the \label was not in the same 
scope as the \caption, the cross-reference would be incorrect. 

A common mistake when trying to create side-by-side figures is to do: 

\begin{figure} [htbp] 

\begin{minipage}{© . 5\linewidth} 

\centering 

\includegraphics{circle} 

\caption{A Circle} 

\label{fig :circle} 

\end{minipage} 

\begin{minipage}{© . 5\linewidth} 

\centering 

\includegraphics {rectangle} 

\caption{A Rectangle} 

\label{fig : rectangle} 

\end{minipage} 

\end{figure} 

This produces one figure on top of the other, instead of side-by-side. This is 
because the blank line indicates a paragraph break, so each minipage is in 
a separate paragraph, so it's not possible for them to be on the same line. 

If you want a bit of spacing in your code to make it more readable, use 
% to comment out the paragraph break. For example: 

\end{minipage}% 

% 

\begin{minipage}{® . 5\linewidth} 




Figure 7.2 A Circle 


Figure 7.3 A Rectangle 


7.2 Tables 

Tables are produced in much the same way as figures, except that the table 
environment is used instead. 
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\begin{table} [( placement specifiers }] 

Where the optional argument (placement specifiers) is as described on 
page 114. 

As mentioned at the start of this chapter, tables typically hâve the caption 
at the top of the table [17]. With the KOMA-Script classes, such as scrartcl, 
scrreprt and scrbook, use the class option captions=tableabove to ensure that 
the vertical spacing appears correctly between the caption and the table 
content and put \caption at the start of the table environment. Page breaks 
are not permitted in the table environment. (The longtable package can be 
used for that instead. See the longtable documentation for further details.) 

Example: 

In the preamble: 

\documentclass [captions=tableabove]{scrbook} 

Later in the document: 


\begin{table} [htbp] 
\caption{A Sample Table} 
\label{tab :sample} 
\centering 
\begin{tabular}{lr} 

Item & Cost\\ 

Video & 8.99\\ 

CD & 9.99W 
DVD & 15.88 
\end{tabular} 

\end{table} 


This produces Table 7.1. 


Table 7.1 A Sample Table 

Item Cost 
Video 8.99 
CD 9.99 
DVD 15.00 

Again, the \centering déclaration is used to centre the tabular environ¬ 
ment. As with figures, you can create a list of tables using the command 

\listoftables 

This créâtes a file with the extension . lot (see Section 2.4). As with the table 
of contents and list of figures, you will need to ETj;X your document twice 
to get the list of tables up-to-date, unless you're using latexmk (as described 
in Section 5.5) in which case it will be done automatically. 
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Exercise 17 (Creating Tables) 

If you did Exercise 7, you should hâve a tabular environment in your 
document. Try turning this into a table, and add Table 7.1. You could also 
try adding a list of tables. As before, you can download or view the solution. 


7.2.1 Side-by-Side Tables 

You can create side-by-side tables using an analogous method to the side- 
by-side figures approach described above. 

Example: 

This example is similar to the one in Section 7.1.1. Again, take care to ensure 
that there is no paragraph break between the two minipage environments. 


t Input 


\begin{table} 

\begin{minipage}{0 . 5\linewidth} 
\caption{Prices for 2011} 
\label{tab:prices2011} 
\centering 
\begin{tabular}{lr} 

Item & Price (£)\\ 

Widgets & 10.99W 
Whatsits & 5.99 
\end{tabular} 

\end{minipage}% 


% 


\begin{minipage}{0 . 5\linewidth} 
\caption{Prices for 2012} 
\label{tab:prices2012} 
\centering 
\begin{ tabular }{lr} 

Item & Price (\pounds)\\ 
Widgets & 11.99W 
Whatsits & 6.99 
\end{tabular} 

\end{minipage}% 

\end{table} 


4- Input 


This produces Tables 7.2 and 7.3. 


Table 7.2 Prices for 2011 


Table 7.3 Prices for 2012 


Item Price (£) 
Widgets 10.99 

Whatsits 5.99 


Item Price (£) 
Widgets 11.99 

Whatsits 6.99 
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7.3 Sideways Floats 

The rotating package provides the sidewaysfigure environment: 

\begin{sideways figure} 

and the sidewaystable environment: 

\begin{sideways table} 

which are like figure and table, respectively, but rotate the entire float (includ- 
ing caption) sideways. This sideways float is always placed on a page of its 
own. 

If you hâve used the twoside class option (or you are using a class like 
scrbook, which defaults to that option) then the sideways floats will be rotated 
clockwise or anti-clockwise, depending on whether they fall on an even 
(verso) or odd (recto) numbered page. (Requires a second ETgX run to get 
it correct.) 

Example: 


\begin{ sidewaysfigure} 

\centering 

\includegraphics [width=0. 75\textheight] {shapes} 
\caption{A Sideways Figure} 

\label{fig :sideways} 

\end{ sidewaysfigure} 


The above code produces Figure 7.4. 


7.4 Sub-Floats 

Some floats hâve sub-floats within them. For example, a figure may contain 
several sub-figures, each of which requires a caption. The simplest way to 
do this is to use the subcaption package that provides the subfigure and subtable 
environments: 

\begin{subfigure} [(pos)] {( width )} 


\begin{subtable} [(pos)] {(width)} 

Within these environments, you can use \caption to create a sub-caption. 
(In addition to the main \caption for the containing figure or table environ¬ 
ment.) 

Note: 

The subcaption package requires the caption package, but doesn't automatically 
load it, so you'II need to load both: 
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Figure 7.4 A Sideways Figure 
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\usepackage{caption, subcaption} 

Example: 

This is very similar to the side-by-side figures example from Section 7.1.1. 


\begin{figure}[htbp] 

\begin{subfigure}[b]{0 . 5\linewidth} 

\centering 

\includegraphics {rectangle} 

\caption{Rectangle}\label{fig : rectangle} 

\end{subfigure}% 

% 

\begin{subfigure}[b]{0 . 5\linewidth} 

\centering 

\includegraphics{circle} 

\caption{Circle}\label{fig :circle} 

\end{subfigure}% 

\caption{Two Shapes} 

\label{fig :shape} 

\end{figure} 

| _ | 

This produces Figure 7.5. Elsewhere in the document, the figure and its 
components can be referenced: 


Figure~\ref{fig :shapes2} shows some shapes. 
Figure~\ref{fig : rectangle} shows a rectangle and 
Figure~\ref{fig :circle} shows a circle. 


which produces the following text: 


Figure 7.5 shows some shapes. Figure 7.5a shows a rectangle and Fig¬ 
ure 7.5b shows a circle. 


You can also reference just the sub-float using 
\subref {(label)} 

which is analogous to \ref, but only displays the sub-float number without 
the number associated with its containing float. 

Example: 


Figure~\ref{fig:shapes2} shows: (\subref{fig : rectangle}) a 
rectangle and (\subref{fig :circle}) a circle. 

produces 

Figure 7.5 shows: (a) a rectangle and (b) a circle. 


Input 

t Input 


4 - Input 

t Input 

4 Input 

t Output 

4 Output 

Définition 

f Input 
4 Input 

Output 









Chapter 7 Floats 


124 



(a) Rectangle (b) Circle 


Figure 7.5 Two Shapes 


Note: 

The subfigure labels (a, b, etc) should typically be in italic [17]. This can be 
achieved with the caption package using: 

\DeclareCaptionLabelFormat{(/ormaf-name)}{(code}} 

where ( format-name) is the name for this new format and (code) is the 
code used to format the label where #2 gets replaced by the reference 
number. 

Once you hâve defined a new format, you can then use 
\captionsetup [(type)] {(options)} 

to switch to that new format. For subfloats, (type) needs to be set to sub. 
The second argument (options) is a (key)=(value) comma-separated list. 
The key that sets the format is labelformat. (For further details about both 
\DeclareCaptionLabelFormat and \captionsetup, see the caption package 
documentation.) 

For example, to create a format called em-noparens that displays the 
number in an emphasized font without parenthèses: 

\DeclareCaptionLabelFormat{em-noparens}{\emph{#2}} 

Now switch to that new format: 

\captionsetup [sub] {labelformat=em-noparens} 

Note that this only changes the caption label format. It doesn't affect the 
font used by \ref or \subref. For \ref, you can use the fncylab package, 
which provides the command: 

\ 1 abe 1 format {( cfr) }{( de/n} } 

Within (defn), use #1 to represent the subfigure value and use \thefigure 
for the encapsulating figure number. For example: 

\labelformat{subfigure}{\thefigure\emph{#l}} 

Now 

\ref{fig :circle} 
will produce 
7.5 a 

Unfortunately, this doesn't work for \subref. Instead you will hâve to do, 
for example, the following in the text: 
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\emph{\subref{fig :circle}} 

If you want to add parenthèses, the above can be modified to: 


\DeclareCaptionLabelFormat{em-parens}{(\emph{#2}) } 

\captionsetup [sub]{labelformat=em-parens} 

\label format{ subfigure }{\thefigure (\emph{#l}) } 

i_i 

For \subref, you will hâve to do, for example, the following in the text: 
(\emph{\subref{fig :circle}}) 

Exercise 18 (Creating Sub-Figures) 

Download the image files rectangle.pdf and circle.pdf from http:// 
www.dickimaw-books.com/latex/novices/html/exercises/ (or create your 
own images) and add Figure 7.5 to your document. You can download or 
view the solution. 


Input 


î Input 


4- Input 


Input 





Chapter 8 

Defining Commands 


It's possible to define your own commands or redefine existing ones. Be 
very careful about redefining existing commands; don't redefine a command 
simply because you want to use the name, only redefine it if you are making 
a modification. For example, if you want to change the format of the current 
date, you would redefine \today, but if you want to define a command to 
display a spécifie date, you should define a new command with a different 
name. 

There are several reasons why you might want to define a new com¬ 
mand: 

1. Reduce typing: 

Suppose you hâve a sériés of commands or text that you find yourself 
frequently using, then you could define a command to do ail these 
other commands for you. 

Example: 

Suppose you want a lot of large bold slanted sans-serif portions of text 
within your document. Every time you type those portions of text, you 
will hâve to do something like: 

\textsf{\large\bfseries\slshape Some text} 

It would be much easier if you could use just one command to do ail 
that, called, say, \largeboldsfsl: 

\largeboldsfsl{Some text} 

or you could call it, say, \lbsfsl which is shorter, but slightly less 
mémorable: 

\lbsfsl{Some text} 

2. Ensure consistency: 

You may find that you want to format an object a certain way. 
Example: 

Recall near the end of Section 7.4, I suggested the following to refer- 
ence a subfigure (when using \subref instead of \ref): 

(\emph{\subref{fig :circle}}) 

For consistency, you might want to define a command, say, 
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\formattedsubref{( label}} 

that was the same as (\emph{\subref{(?abe?)}}). 

Another Example 

Suppose your document has a lot of keywords in it, and you want to 
format these keywords in a different font, say sans-serif, so that they 
stand out. You could just do: 

A \textsf{command} usually begins with a backslash. 

however, it is better to define a new command called, say, \keyword 
that will typeset its argument in a sans-serif font. That way it becomes 
a lot easier to change the format at some later date. For example, you 
may décidé to splash out and hâve your keywords typed in a particular 
colour. In which case, ail you need to do is simply change the définition 
of the command \keyword, otherwise you'll hâve to go through your 
entire document looking for keywords and changing each one which 
could be very time consuming if you hâve a large document. You might 
also décidé at some later date to make an index for your document. 
Indexing ail the keywords then becomes much simpler, as again ail 
you'll need to do is modify the \keyword command. 

New commands are defined using the command: 

\newcommand {(cmd)} [(n-args)] [( default }] {( text }} 

The first mandatory argument (cmd) is the name of your new command, 
which must start with a backslash. The optional argument ( n-args) spécifiés 
how many arguments your new command must take. The next optional 
argument ( default } will be discussed later. The final mandatory argument 
(text) spécifiés what should do every time it encounters this command. 

Example (No Parameters): 

Let's begin with a trivial example. Suppose I wanted to write a document 
about a particular course, say "Programming — Languages and Software 
Construction", and I had to keep writing the course title, then I might décidé 
to define a command that prints the course title rather than having to labo- 
riously type it out every time. Let's call our new command \coursetitle. 
We want the following code: 

The course \emph{\coursetitle} is an undergraduate course, 
to produce the following output: 


The course Programming — Languages and Software Construction is 
an undergraduate course. 


Clearly this command doesn't need any arguments, so we don't need to 
worry about the optional argument (n-args) to \newcommand, and the only 
thing our new command needs to do is print: 
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Programming - Languages and Software Construction 

so we would define our new command as follows: 

\newcommand{\coursetitle} {Programming - Languages and Software 

Construction} 

_I 4- Input 

Commands must always be defined before they are used. The best place to 
define commands is in the preamble: 


1 t Input 

\documentclass{scrartcl} 

\newcommand{\coursetitle} {Programming - Languages 

and Software Construction} 

\begin{document} 

\section{\coursetitle} 

The course \emph{\coursetitle} is an undergraduate course. 

\end{document} 

I_I i Input 


Example (One Mandatory Argument): 

Now let's try defining a command that takes an argument (or parameter). 
Let's go back to our \keyword example on the previous page. This command 
needs to take one argument that is the keyword. Let's suppose we want 
keywords to corne out in sans-serif, then we could do: 


\newcommand{\keyword}[1] {\textsf{#l}} 


Input 


In this case we hâve used the optional argument ( n-args } to \newcommand. 
We want our command \keyword to hâve one argument, so we hâve [1]. In 
\textsf{#l} the #1 represents the first argument. (If we had more than one 
argument, #2 would represent the second argument, #3 would represent the 
third argument etc. up to a maximum of 9.) So 

\keyword{commands} 

will be équivalent to 


[FAQ: How to 
break the 
9-argument limit] 


\textsf {commands} 


and 


\keyword{environment} 
will be équivalent to 
\textsf{ environment} 

and so on. Again, it's best to put the command définition in the preamble 
to ensure the command won't be used before it's defined. 
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\documentclass{scrartcl} 

\newcommand{\keyword}[1] {\textsf{#l}} 

\begin{document} 

A \keyword{command} usually begins with a backslash. 

\end{document} 

I ^ >.. . 1-1^-—. . ...... ^-- 'A 

Now if we want to change the way the keywords are formatted, we can 
simply change the définition of \keyword. Let's modify our code so that the 
keyword is now in a slanted sans-serif font: 


\documentclass{scrartcl} 

\newcommand{\keyword}[1] {\textsf{\slshape #1}} 

\begin{document} 

A \keyword{command} usually begins with a backslash. 

\end{document} 

i_i 

Let's go one stage further. The color package provides the déclaration: 
\color {(col-name)} 

which switches the foreground colour to ( col-name }. It also provides the 
text-block command: 

\textcolor {(col-name)} {(text)} 

which sets (text) in the colour given by (col-name). 

So let's use the color package to make our keywords blue: 

i i 

\documentclass{scrartcl} 

\usepackage {color} 

\newcommand{\keyword}[1]{\textsf{\slshape\color{blue}#l}} 
\begin{document} 

A \keyword{command} usually begins with a backslash. 
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Or we could index the keywords. To do this we need the makeidx package 
and the commands \makeindex, \index{(fexf}} and \printindex: 


\documentclass{scrartcl} 

\usepackage {makeidx} 

\makeindex 

\newcommand{\keyword}[1] {\textsf{\slshape #l}\index{#l}} 
\begin{document} 

A \keyword{command} usually begins with a backslash. 

\printindex 

\end{document} 


For further information about how to create an index, see A Guide to 
BTgX [7] or The ETpX Companion [3]. Alternative^, if y ou want a brief 
overview, try Using BTpX to Write a PhD Thesis [13]. 

Since it is unlikely that the keyword will contain a paragraph break, we 
should indicate that this is a short command using the starred form: 

\newcommand*{\keyword}[1] {\textsf{\slshape #l}\index{#l}} 

Now if you forget to add the closing brace, for example, \keyword{command, 
then TgX's error checking mechanism will pick up the error sooner. This 
will give an error message that looks like: 

! Paragraph ended before \keyword was complété. 

<to be read again> 

\par 

1.604 

This at least gives you the line number (604 in this example) of the end of 
the paragraph where the error has occurred. 

If you don't used the starred form of \newcommand, then you will get the 
somewhat less than helpful error: 

! File ended while scanning use of \keyword. 

If you hâve a very large document, it may take a while to track down where 
exactly you hâve missed a brace. 

Exercise 19 (Defining a New Command) 
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1 t Code 

\documentclass{scrartcl} 

\newcommand*{\keyword}[1] {\textsf{#l}} 

\begin{document} 

A \keyword{command} usually begins with a backslash. 

Segments of code may be \keyword{grouped}. 

Some \keyword{commands} take one or more \keyword{arguments}. 
\end{document} 

I_I t Code 


Then modify your code so that the keywords are in a slanted sans-serif 
font or modify your code so that the keywords corne out in blue (using the 
color package as in the example earlier). Again you can download or view 
the resuit. 

For THE MORE ADVENTUROUS: 

If you want to create an index as in the previous example, you will need to 
use the application makeindex. If you used latexmk back in Section 5.5, you 
can just carry on using that as before. If not you need to do the following 
in TeXworks: 

1. Create the PDF as described in Section 3.1. 

2. Select Makeindex from the drop-down list next to the build (typeset) 
button (see Figure 8.1). 

3. Click on the build button. If ail goes well, you won't see anything 
different. If you see something like the following: 

Couldn’t find input index file exercisel9 nor exercisel9.idx. 

then you probably forgot to add the command \makeindex to the pream- 
ble. Add it in and go back to Step 1. 

4. Select pdfLaTeX from the drop-down list and build the PDF file again. 
Move to the last page of the PDF, and you should see the index. 


8.1 Defining Commands with an Optionaï 
Argument 

As mentioned earlier, the \newcommand command has a second optionaï 
argument ( default ). This allows you to define a command with an optionaï 
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Figure 8.1 Selecting Makelndex in TeXWorks 









Chapter 8 Defining Commands 


133 


argument. For example, suppose we want a command called, say, \price. 
Suppose we want the following code: 

\price{l®0} 

to produce the following output: 

£100 excl VAT @ 17.5% 

and let's suppose we want an optional argument so that we can change the 
VAT. That is, we would want the following code: 

\price[20]{30} 

to produce the following output: 

£30 excl VAT @ 20% 

Therefore we want to define a command such that if the optional argument 
is absent we will hâve 17.5, and if it is présent the optional argument will 
be substituted instead. This command can be defined as follows: 

\newcommand{\price}[2] [17 .5] {\pounds #2 excl VAT @ #1\%} 

Flere, #1 represents the optional argument (by default 17.5) and #2 repre- 
sents the mandatory argument (the second argument if the optional argu¬ 
ment is présent, or the only argument if the optional argument is absent.) 

As before, since the argument is unlikely to contain a paragraph break, 
we should indicate that it is a short command using the starred form: 

\newcommand*{\price} [2][17 . 5] {\pounds #2 excl VAT @ #1\%} 

Exercise 20 (Defining Commands with an Optional Argu¬ 
ment) 

In this exercise, you will need to define a slightly modified version of the 
above example. Try defining a command called, say, \cost. It should take 
one optional argument and one mandatory argument. Without the optional 
argument, it behaves in the same way as the \price example above, so that, 
say, 

\cost{50} 

will produce 

£50 excl VAT @ 17.5% 

but with the optional argument, you can change the excl VAT @ 17.5\% bit. 
So that, say, 

\cost[inc VAT]{50} 

will produce 

£50 inc VAT 

You can download or view the solution. 

For THE MORE ADVENTUROUS: 

If you did Exercise 19 and you modified \keyword so that it indexed the 
keyword, you may hâve noticed that 


[FAQ: More than 
one optional 
argument] 
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\keyword{command} 

and 

\keyword{commands} 

produced separate entries in the index. It would be better to hâve an optional 
argument to override the indexing mechanism. For example, 

\keyword{command} 

should print and index the word "command", whereas 
\keyword[command]{commands} 

should print "commands" and index "command". In other words, we need 
an optional argument that defaults to the mandatory argument if it is not 
présent. This is how to achieve that type of effect: 81 

i i 

\newcommand*{\keyword}[2] [\keywordentry ] {% 

\def\keywordentry{#2 }% 

\textsf{#2}% 

\index{#l}% 

} 

i_j 

In this example, the default value for the optional argument is set to the 
command \keywordentry. At the start of \keyword this is defined to be the 
mandatory argument (as specified by #2) using TjrX's \def command: 82 

\def\keywordentry{#2 } 

Then typeset the keyword (given in the mandatory argument #2) in a sans- 
serif font: 

\textsf{#2} 

Now index the term using the optional argument (#1): 

\index{#l} 

If an optional argument is specified, #1 will be the given argument, but if the 
optional argument is missing, #1 will be \keywordentry, which has earlier 
been set to the mandatory argument #2. 


8.2 Redefining Commands 

Commands can be redefined using the command: 
\renewcommand {(cmd)} [( n-args }] [( default }] {( text }} 


81 Recall from Chapter 2 (Some Définitions) the percent symbol discards the space resulting 
from the end of line character. 

82 \def is too complicated for an introductory I')TpX guide but, if you're interested, read The 
TpKbook [6], 
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This has exactly the same format as \newcommand but is used for redefining 
existing commands. Again there is a starred version to indicate that the 
command is a short command. 



Never redefine a command whose existing function is unknown to you or 
just because you want to use a particular command name, regardless of 
its previous function. By way of illustration: as a production editor, I hâve 
to combine articles by different authors into a single book. Each author 
supplies the ETgX code for their own article. Every so often, I get code that 
redefines a command for the convenience of the author. Later on another 
author tries to use the same command, on the assumption that the command 
behaves according to its original définition. This tends to involve the accent 
commands as they are short and that saves the author typing. It usually 
goes along these lines: author A redefines \c (the cedilla accent command) 
to display a maths bold "c" to indicate a vector. Later, author B, uses the 
cedilla accent, say, in the name François: 

Fran\c{c}ois 

Author As hack turns this into Franccois. 

Example (Redefining List Labels): 

Recall the itemize environment discussed in Section 4.4.1. You may hâve up 
to four nested itemize environments, the labels for the outer environment are 
specified by the command \labelitemi, the labels for the second level are 
specified by \labelitemii, the third by \labelitemiii and the fourth by 
\labelitemiv. By default, \labelitemi is a bullet point (•), \labelitemii 
is an en dash (-), \labelitemiii is an asterisk (*) and \labelitemiv is a 
centred dot (•)• These can be changed by redefining \labelitemi etc. 

Recall from Table 4.2 that the command \dag produces a dagger Symbol, 
we can use this symbol instead of a bullet point: 


\renewcommand*{\labeliterni}{\dag} 

\begin{ itemize} 

\item Animal 

\item Minerai 

\item Vegetable 

\end{itemize} 

_I 4* Input 

Output: 


t Output 

■f Animal 
■f Minerai 
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■f Vegetable 


Here's another example, it uses the PostScript font ZapfDingbats via the 
pifont package: 


\renewcommand*{\labeliterni} {\ding {43}} 
\begin{itemize} 

\item Animal 

\item Minerai 

\item Vegetable 

\end{itemize} 


Output: 


bs= Animal 
b®' Minerai 
bs" Vegetable 

i_i 

In the above example, it would actually be easier to use the dinglist environ¬ 
ment defined in the pifont package: 

i i 

\begin{dinglist}{43} 

\item Animal 
\item Minerai 
\item Vegetable 
\end{dinglist} 

t j 

Example (Redefining the Default Font): 

Recall from Section 4.5.3 that the default font family is usually the serif 
(Roman) family. So what happens if you need to write your entire document 
in, say, Helvetica? The default font family name is stored in: 
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This command is usually defined to be just \rmdefault, which in turn stores 
the name of the default serif font (initially cmr. Computer Modem Roman). 
If you want the default font to be sans-serif, ail you need do is add the 
following line to the preamble: 

\renewcommand{\familydefault}{\sfdefault} 

\sfdefault stores the name of the default sans-serif font (initially cmss, 
Computer Modem Sans-Serif) and the helvet package redefines \sfdefault 
to phv, which is the identifier for the Helvetica font. So the following docu¬ 
ment will be in Helvetica: 

\documentclass{scrartcl} 

\usepackage {helvet} 

\renewcommand{\familydefault}{\sfdefault} 

\begin{document} 

This is a sample document. 

\end{document} 

Similarly, if you want the default font to be monospaced (typewriter) then 
you'd need to do: 

\renewcommand{\familydefault}{\ttdefault} 

Incidentally, you may hâve noticed in Section 4.5.3 that although I said 
I'd used the anttor and libris packages to set the serif and sans-serif families 
for this book, I didn't mention anything about the typewriter (monospaced) 
font. I used the TXTT font, but that doesn't hâve a corresponding package. 
You just redefine \ttdefault to txtt: 

\renewcommand*{\ttdefault}{txtt} 

Example (Redefining Fixed Names): 

You may hâve noticed that ETjrX automatically generates pièces of text such 
as "Chapter", "Figure", "Bibliography". These are generated by the com¬ 
mands shown in Table 8.1. 

You can change the defaults using \renewcommand. For example, suppose 
you want the table of contents to be labelled "Table of Contents", instead of 
the default "Contents", you would need to do: 

\renewcommand*{\contentsname}{Table of Contents} 

In fact, the babel package (see Section 5.8) uses this method to redefine the 
commands in Table 8.1 whenever you switch language using 
\selectlanguage or within the contents of the otherlanguage environment. 
This unfortunately has the side-effect that means if you try to redefine 
these commands, babel will automatically overwrite your définition when¬ 
ever there's a language change, which includes at the beginning of the 
document environment. Instead you need to use babel's \addto mechanism. 


Input 


Input 


Input 


Input 

[FAQ: Changing 
the words babel 
uses] 


\addto { ( command ) } { ( code) } 


Définition 
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Table 8.1 Predefined Names fBook and report style classes (such as scrreprt 
and scrbook), ^article-style classes (such as scrartcl), remainder book, 
report and article-style classes) 


Command Default Text 


\contentsname 

\listfigurename 

\listtablename 

\bibname^ 

\refnamel 

\indexname 

\figurename 

\tablename 

\partname 

\chaptername^ 

\appendixname 

\abstractname 


Contents 

List of Figures 

List of Tables 

Bibliography 

References 

Index 

Figure 

Table 

Part 

Chapter 

Appendix 

Abstract 


This patches the définition of a command (specified in the first argument) 
adding (code) to the end of the command définition. Whenever babel switches 
the current language, it uses the command \captions(langruage), which 
performs ail the redéfinitions of commands like those listed in Table 8.1. 
For example, if you are using babel with the english option and you want to 
change \contentsname so that it does "Table of Contents" instead of "Con¬ 
tents", you need to do: 


1 1 î Input 

\addto{\captionsenglish}{% 

\renewcommand{\contentsname}{Table of Contents}% 

} 

!_! 4- Input 

A 


x 

This will cause an infinité loop where \foo recursively calls itself. Instead 
you should use one of the commands provided by the etoolbox package (such 
as \appto, which has the same syntax as babel's \addto described above). For 
further details, read the etoolbox documentation. 

Exercise 21 (Renewing Commands) 

If you did Exercises 16 and 17, go back to that document and changed the 
figures and tables so that they are labelled "Fig" and "Tab" instead of "Figure" 
and "Table". Hint: you need to redefine \tablename and \figurename. 


Notes: 

Take care if you want to patch an existing command. For example, suppose 
you want to append something to the action of a command. You might be 
tempted to do 

\renewcommand*{\foo}{\foo Something else} 
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You can download or view the solution. 



Chapter 9 
Mathematics 


As mentioned in the introduction, ETgX is particularly good at typesetting 
mathematics. In order to use any of the maths commands we need to be in 
one of the mathematics environments. There are two basic types of math¬ 
ematics: in-line maths and displayed maths. In-line maths is mathematics 
that occurs within a line of text, for example: 

The variable x is transformed by the function /(x). 

Displayed maths is mathematics that occurs on a line of its own. For exam¬ 
ple: 


A polynomial is a function of the form 

n 

/(x) = y, g,x' 

i =0 


The maths environments switch to ETgX's "math mode", which uses special- 
ist maths fonts and spacing rather than just using an italic font. 

If you want to typeset any mathematics, I strongly advise using the ams- 
math package: 

\usepackage{amsmath} 

This patches some existing ETgX commands and environments and also 
provides many useful additions. 

This chapter is just an introduction to typesetting mathematics in ETgX. 
If you want a comprehensive guide, I recommend you read Math Mode by 
Herbert Vol?» [20], which can be access via texdoc (see Section 1.1): 

texdoc mathmode 


9.1 In-Line Mathematics 

In-line mathematics is created using the math environment. (Note U.S. spelling 
— "math" not "maths"). 


Output 


t Output 


i Output 
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Example: 


The variable \begin{math}x\end{math} is transformed by the 
function \begin{math}f(x)\end{math> . 

i_i 

It's somewhat cumbersome having to type \begin{math} and \end{math} 
and it also makes the source code a little difficult to read so there are 
shorthand notations that can be used instead: \( is équivalent to \begin 
{math} and \) is équivalent to \end{math}. So the example above can be 
rewritten: 

The variable \(x\) is transformed by the function \(f(x)\). 

There is an even shorter notation: The spécial character $ is équivalent to 
both \begin{math} and \end{math}: 

The variable $x$ is transformed by the function $f(x)$. 

This is considerably easier to type and to read, but you need to make sure 
that ail your $ symbols hâve matching pairs. The above code will look like: 

The variable x is transformed by the function /(x). 

The other advantage in using $ over \( and \) is that $ is a robust command, 
whereas \( and \) are fragile commands and will need to be protected if 
they occur in a moving argument. 

Note: you should always make sure you are in maths mode to typeset 
any variables (such as x, y, z), as this will ensure that the correct maths 
fonts are used, as well as the appropriate spacing. Similarly, don't use $ as 
a short eut for an italic font. 

Notice the îdifferenceS between $(x’, y’, z’)$ and \textit{(x’, 
y’, z’)}. 

Notice the différence between (x' ,y' ,z') and (x', y', z'). 

9.2 Displayed Mathematics 

One-line unnumbered displayed mathematics can be created using: 

\[( maths }\] 

where (maths) is the mathematics to be displayed. 

Example: 


A linear function is a function of the form 
\[ y = mx + c \] 


■f Input 
4, Input 


Input 

Input 

Output 


Input 

Output 


Définition 

î Input 

i Input 


Output: 
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A linear function is a function of the form 

y = mx + c 


Don't use the displaymath environment or $$... $$ [15]. Use \[ and \] with 
the amsmath package. 

The équation environment provides something similar to \[ \], except 
that the équation is numbered. Modifying the above example: 


A linear function is a function of the form 
\begin{ équation} 
y = mx + c 
\end{equation} 


results in the following output: 


A linear function is a function of the form 

y = mx + c (9.1) 


Normal text can be inserted into the équation using 
\text{(fexf}} 

which is provided by the amsmath package. 
Example: 

\[ x = 2 \text{ and } y = -1 \] 
results in the following output: 


x = 2 and y = -1 


Recall from Section 5.5 that we can cross-reference most things that 
ETeX automatically numbers using \ref and \label. Equations can be cross- 
referenced in the same way: 


î Output 


i Output 

A 


t Input 


4- Input 


t Output 


4 Output 


Définition 


Input 


t Output 


4 Output 

[FAQ: Re-using 
an équation] 
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1 t Input 

Equation~\ref{eqn: linear} is a linear function. 

\begin{ équation} 

\label{eqn: linear} 
f(x) = mx + c 
\end{equation} 

l i Input 


Equation 9.2 is a linear function. 


t Output 


f[x) = mx + c 


(9.2) 


I_I i Output 

Equation numbers are usually given in parenthèses, which can be done 


using: 

Equation- (\ref{eqn: linear}) nput 

The amsmath package provides a convenient short eut: 

\eqref{(label)} Définition 

So the above can be written as: 

Equation~\eqref{eqn: linear} 

Equation (9.2) Output 

Note: 


Both the équation environment and \[...\] are only designed for one line of 
maths. Therefore you must not hâve any line breaks or paragraph breaks 
within them. The following will cause an error: 

\begin{ équation} 
f(x) = mx + c 
\end{equation} 

Either remove the blank lines or comment them out: 

\begin{ équation} 

% 

f(x) = mx + c 

% 

\end{equation} 


✓ 

✓ 


X 

X 
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9.3 Multiple Lines of Displayed Maths 

The amsmath package provides the align and align* environments for aligned 
équations. The starred version doesn't number the équations. These en¬ 
vironments provide pairs of left- and right-aligned columns. As with the 
tabular environment, use & to separate columns and \\ to separate rows. Un- 
like the tabular environment, there is no argument as the column specifiers 
are predefined. Another différence is that no page breaks can occur in the 
tabular environment, but it's possible to allow a page break in align or align* 
using 

\displaybreak[(n)] 

immediately before the \\ where it is to take effect. The optional argument 
is a number from 0 to 4 indicating the desirability to break the page (from 0 
the least to 4 the most). 

If you want to mix numbered and unnumbered rows, you can use 
\notag 

to suppress the numbering for a particular row in the align environment. 
This command must go before \\ at the end of the row. The default équation 
numbering can be overridden for a particular row using: 

\tag{(fag)} 

where ( tag) is the replacement for the équation number. 

Don't use the eqnarray or eqnarray* environments. They're obsolète [15]. 

Example (Unnumbered): 


\begin{align*} 
y &= 2x + 2\\ 
&= 2(x+1) 
\end{align*} 


y = 2x + 2 
= 2(x + 1) 


Note that the equals sign is placed at the start of the second column, after 
the ampersand &. This ensures the correct amount of spacing on either 
side. If the first line of the above équation was changed to: 


Définition 


Définition 


Définition 

A 


t Input 


i Input 


t Output 


4. Output 


y =& 2x + 2\\ 


X 
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there wouldn't be enough space on the right of the equal sign: 

y =2x + 2 


Example (One Row Numbered): 

\begin{align} 
y &= 2x + 2\notag\\ 

&= 2(x+1) 

\end{align} 


y = 2x + 2 

= 2(x + 1) (9.3) 


Example (Four Columns): 

\begin{align*} 
y &= 2x + 2 & z &= 6x + 3\\ 
&= 2(x+1) & &= 3(2x+l) 

\end{align*} 


y = 2x + 2 
= 2(x + 1) 


z = 6x + 3 
= 3(2x + 1) 


As with équation, you can cross-reference individual rows of an align envi¬ 
ronment, but you must remember to put \label before the end of row \\ 
separator. You can reference a row in the align* environment if you hâve as- 
signed it a tag with \tag, but don't try labelling a row in the align environment 
where the numbering has been suppressed with \notag. 

Example (Cross-Referenced): 

This example has two numbered équations in an align environment, both of 
which are labelled and referenced: 


t In put 


4_ Input 


t Output 


J. Output 


f Input 


4 - Input 


t Output 


4. Output 
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The function $f(x)$ is given in Equation~\eqref{eq: fx}, and its 
dérivative $f’(x)$ is given in Equation~\eqref{eq :dfx}. 
\begin{align} 

f(x) &= 2x + 1 \label{eq: fx}\\ 
f’(x) &= 2 \label{eq:dfx} 

\end{align} 


The function /(x) is given in Equation (9.4), and its dérivative f'(x ) is given 
in Equation (9.5). 


/(x) = 2x + 1 (9.4) 

/'(x) = 2 (9.5) 


Recall the command \text{(fexf}} from the previous section. This can 
be used within cells of the align and align* environments, but the amsmath 
package also provides 

\intertext {(text)} 

which can be used for a line of interjection between the rows. This com¬ 
mand may only go right after \\. 

Example 


\begin{align*} 
y &= 2x + 2\\ 

\intertext{Using the distributive law:} 
&= 2(x+1) 

\end{align*} 


y = 2x + 2 


Using the distributive law: 


= 2(x + 1) 


There are other environments for multiple-line displayed maths, but they 
are beyond the scope of this book. See the amsmath documentation for 
further details. 


t Input 


4- Input 


t Output 


X Output 


Définition 


f Input 


X Input 


t Output 


X Output 
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9.4 Mathematical Commands 

Most of the commands described in this section may only be used in one of 
the mathematics environments. If you try to use a mathematics command 
outside a maths environment you will get a "Missing $ inserted" error 
message. 

9.4.1 Maths Fonts 

Just as we are able to change text fonts using the commands \textrm, 
\textbf etc, we can also use commands to change the maths font. Basic 
maths font changing commands are shown in Table 9.1. 

Table 9.1 Maths Font Changing Commands 


Command 

Example Input 

Corresponding Output 

(Computer Modem) 

\mathrm {(maths)} 

$\mathrm{xyz}$ 

xyz 

\maths f { ( maths ) } 

$\mathsf{xyz}$ 

xyz 

\mathtt {(maths)} 

$\mathtt{xyz}$ 

xyz 

\mathi t { (maths)} 

$\mathit{xyz}$ 

xyz 

\mathb f { ( maths } } 

$\mathbf{xyz}$ 

xyz 

\mathcal {(maths)} 

$\mathcal{XYZ}$ 

æyz 


The calligraphie fonts via \mathcal are only available for upper-case 
characters. Table 9.2 lists additional font commands supplied with the ams- 
math and amsfonts packages. 

Table 9.2 The amsfonts 1 and amsmatlT Font Commands 


Command 

Example Input 

Example Output 

*\mathbb {(maths)} 
*\mathfrak{ (maths)} 
t \boldsymbol {(maths)} 
\pmb{(symhol)} 

$\mathbb{A+B=C}$ 
$\mathfrak{A+B=C}$ 
$\boldsymbol{A+B=C}$ 
$\pmb{+-=}$ 

A + 1 = C 

21 + 03 = £ 

A + B = C 

+ - = 


9.4.2 Greek Letters 

Greek letters that differ from the corresponding Roman letters are obtained 
by placing a backslash in front of the name. 91 Lower case and upper case 
Greek letters are shown in Table 9.3 and Table 9.4, respectively. There are 
also some variants of certain symbols, such as \vartheta as opposed to 
\theta. 


9.1 


[FAQ: Better 
script fonts for 
maths] 


So, for example, there is no omicron since it looks the same as a Roman o. 









Chapter 9 Mathematics 148 


Table 9.3 Lower Case Greek Letters 


\alpha 

a 

\beta 

JS 

\gamma 


7 

\delta 

ô 

\epsilon 

e 

\varepsilon 

e 

\zeta 

C 

\eta 

V 

\theta 


e 

\vartheta 

û 

\iota 

L 

\kappa 


fC 

\lambda 

A 

\mu 

P 

\nu 


V 

\xi 

e 

\pi 

7X 

\varpi 


O 

\rho 

P 

\varrho 

Q 

\sigma 


a 

\varsigma 

Ç 

\tau 

T 

\upsilon 


V 

\phi 

</> 

\varphi 

<P 

\chi 


X 

\psi 


\omega 

CO 




Table 9.4 Upper Case Greek Letters 



\Gamma 

r 

\Delta 

A 

\Theta 

© 


\Lambda 

A 

\Xi 

a 

\Pi 

n 


\Sigma 

E 

\Upsilon 

Y 

\Phi 



\Psi 

T 

\Omega 

Q 





Example: 

The following code 

\[ x’ = x + \Delta x \] 

produces: 

x' = x + Ax 

9.4.3 Subscripts and Superscripts 

Subscripts are obtained either by the command 
\sb {(maths)} 

or by the spécial character: 

_{(maths }} 

Superscripts are obtained either by the command 
\sp {(maths)} 

or by the spécial character: 

A {(maths)} 

Examples: 

1. This example uses \sb and \sp: 


Input 


Output 


Définition 


Définition 


Définition 


Définition 


\ [y = x\sb{l}\sp{2} + x\sb{2}\sp{2}\] 


Input 
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2. This example uses _ and A 

\[y = x_{l} A {2} + x_{2} A {2}\] 

3. Recall from page 16 that mandatory arguments only consisting of one 
character don't need to be grouped, so the above code can also be 
written as: 

\ [y = x_l A 2 + x_2 A 2\] 

This is simpler than the first two examples. However it's a good idea 
to be in the habit of always using braces in case you forgot them when 
they're needed. 

Ail three of the above examples produce the same output: 

y = xf + x\ Output 

Notice how the subscript gets tucked under the slope of the A in: 

\[ Y_{1} a {2} \] 

V 2 Output 

1 1 

Compare with 

\C A {2} \] 

y' 2 Output 

Example (Nested) 

Subscripts and superscripts can also be nested (note that it is now necessary 
to group the argument to the superscript command): 

\[ f(x) = e A {x„l} \] 
which produces 

/(x) = e Xl 0 ut P ut 

This example isn't quite right as e isn't actually a variable and shouldn't 
be typeset in italic. The correct way to do this is: 

\[ f(x) = \mathrm{e} A {x„l} \] 
which results in: 

/(x) = e 11 Output 

If you are going to use e a lot, it will be simpler to define a new command 
to do this. The définition should go in the preamble: 

\newcommand{\e}{\mathrm{e}} 

Then in the document: 

\[ f(x_l, x_2) = \e A {x_l A 2} + \e A {x_2 A 2} \] 

/ (xi, X 2 ) = e x i + e x 2 Output 

Take care when nesting subscripts or superscripts. The following 
x_l_2 X 

will give a ! Double subscript error. 
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9.4.4 Functional Names 

Functions such as log and tan can't simply be typed in as log or tan oth- 
erwise they will corne out looking like the variables l times o times g {log) 
or t times a times n (tan). Instead you should use one of the commands 
listed in Table 9.5. The functions denoted with 1 can hâve limits by using 
the subscript command _ or the superscript command A . In addition, the 
modulo commands listed in Table 9.6 are also available. 

Table 9.5 Function Names (hndicates command may hâve limits, Mefined by 
amsmath). 


\arccos 

arccos 

\arcsin 

arcsin 

\arctan 

arctan 

\arg 

arg 

\cos 

cos 

\cosh 

cosh 

\cot 

cot 

\coth 

coth 

\csc 

CSC 

\deg 

deg 

\detF 

det 

\dim 

dim 

\exp 

exp 

\gcd T 

gcd 

\hom 

hom 

\inff 

inf 

\injlimT 

inj lim 

\ker 

ker 

\ lg 

ig 

\liirF 

lim 

\liminfl 

lim inf 

\limsup^ 

lim sup 

\ln 

ln 

\log 

log 

\max^ 

max 

\min T 

min 

\Pr T 

Pr 

\projlimT 

proj lim 

\sec 

sec 

\sin 

sin 

\sinh 

sinh 

\sup T 

sup 

\tan 

tan 

\tanh 

tanh 

\varinjlimT 

lim 

\varliminfîî 

lim 

\varlimsupT 

lim 

\varprojlimT 

lim 




Table 9.6 Modulo Commands (Mefined by amsmath package) 


Command 

Example Input 

Example Output 

\bmod 

$m \bmod n$ 

m mod n 

\pmod {(maths)} 

$m \pmod{n}$ 

m (mod n) 

\mod{ (maths)}^ 

$m \mod{n}$ 

m mod n 

\pod{ (maths)}^ 

$m \pod{n}$ 

m (n) 


Example (Trigonometrïc Functions): 

This example uses the cos and sin functions and also the Greek letter thêta. 
\[ z = r(\cos\theta + i\sin\theta) \] 

z = r( cos 6 + i sin 6) 


Example (Limit): 

The command \infty is the infinity symbol oo, and the command \to dis- 
plays an arrow pointing to the right. Note the use of _ since the limit is a 
subscript. 

\[ \lim_{x\to\infty} f(x) \] 

lim f(x) 


[FAQ: Sub- and 
superscript 
positioning for 
operators] 


Input 

Output 


Input 


Output 
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The operators with limits behave differently depending on whether they 
are in displayed or in-line maths. Notice the différence when the same code 
appears in-line: 

In a line of text $\lim_{x\to\infty} f(x)$ 
which now displays as: 

In a line of text lim z ^ 00 /(x) 

Example (With Subscript): 

This is another example of a functional name using a subscript: 

\[ \min_x f(x) \] 

min/(x) 

X 

Again, notice the différence when it is used in-line: 

In a line of text $\min_x f(x)$ 

In a line of text min x f(x) 


Defining New Functional Operators 

It may be that you want a function that isn't specified in Table 9.5. In this 
case, the amsmath provides the preamble only command 

\DeclareMathOperator {(cmd)}{(operator name)} 

or its starred variant 

\DeclareMathOperator * { (cmd) } { ( operator name) } 

Both versions define a command called (cmd), which must start with a 
backslash, that typesets ( operator name) as a function name. The starred 
version is for function names that can take limits (like \lim and \min de- 
scribed above). 

Example (Operator Without Limits): 

Suppose I want a function called card, which represents the cardinality of a 
set S. First I need to define the new operator command (which I'm going 
to call \card) in the preamble : 

\DeclareMathOperator{\card}{card} 

This operator doesn't take any limits, so I hâve used the unstarred version. 
Later in the document, I can use this new operator command: 

\[ n = \card(\mathcal{S}) \] 

n = card (S) 

In this example \mathcal is used as sets are typically represented in a cal¬ 
ligraphie font. 


Input 

Output 

Input 

Output 

Input 

Output 


Définition 

Définition 

[FAQ: Defining a 
new log-like 
function in 
LaTeX] 


Input 

Input 

Output 
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Example (Operator With Limits): 

Suppose I now want a function called mode, which represents the mode of 
a set of numbers. First, I define the operator command in the preamble: 

\DeclareMathOperator*{\mode}{mode} 

This operator needs to be able to hâve a subscript, so I hâve used the starred 
version. 

Later in the document, I can use this new operator command: 

\[ xjn = \mode_{x \in \mathcal{S}} (x) \] 

x m = mode(x) 

16 S 


9.4.5 Fractions 


Fractions are created using the command 
\ f r ac { ( numerator } } { ( denominator ) } 

The amsmath package also provides the command 


\cfrac[(pos}]{( numerator } } { ( denom inator } } 

which is designed for continued fractions. The optional argument pos can 
be used for left (1) or right (r) placement of any of the numerators. (The 
default is centred.) 


Example: 

A simple fraction: 


\[ \frac{l}{l+x} \] 


Produces: 


Compare with: 

In-line: $ \frac{l}{l+x} $ 
which produces: 

In-line: 

î+z 


1 

1 + x 


Example (Nested): 

\[ \frac{l+\frac{l}{x}}{l+x+x A 2} \] 


1 + X + X 2 

Example (Continued Fraction); 

A continued fraction (example taken from amsmath documentation and uses 
\sqrt, described in Section 9.4.6, and \dotsb, described in Section 9.4.7): 


Input 


Input 

Output 


Définition 


Définition 


Input 


Output 


Input 


Output 


Input 


Output 
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1 1 î Input 

\[ 

\cfrac{l}{\sqrt{2}+ 

\cfrac{l}{\sqrt{2}+ 

\cfrac{l}{\sqrt{2}+\dotsb 

}}} 

\] 

i i Input 


V2 + 


V2 + 


V2 


+ 


î Output 


X Output 


Example (A Dérivative): 

\[ f’(x) = \frac{df}{dx} \] input 


- Tr 

As with "e", the differential operator "d" should be in an upright font as it is 
not a variable: 


Output 


1 1 î Input 

\[ 

f’(x) = \frac{\mathrm{d}f}{\mathrm{d}x} 

\] 

I_I i Input 


f'(x ) = Output 

dx 

The above example is rather cumbersome, particularly if you hâve a lot 
of dérivatives, so it might be easier to define a new command (see Chapter 8 
(Defining Commands)). In the preamble define: 

\newcommand{\deriv}[2]{\frac{\mathrm{d}#l}{\mathrm{d}#2}} 

Then in the document: 


\[ f’(x) = \deriv{f}{x} \] 


Input 


f'(x) = Output 

dx 

Example (Partial Dérivative): 

Partial dérivatives can be obtained similarly using the command \partial 
to display the partial dérivative Symbol. As in the previous example, first 
define a new command to format a partial dérivative in the preamble: 
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\newcommand{\pderiv}[2] {\frac{\partial #l}\partial #2} 
Then in the document: 

\[ f_x = \pderiv{f}{x} \] 

u-%- 

ox 

Example (Double Partial Dérivative): 


\C 

f_{xy} = \frac{\partial A 2 f}{\partial x \partial y} 

\] 


txy 


cPf 

dxdy 


Example (First principles): 


\[ 

f’(x) = \lim_{\Delta x \to 0} 
\frac{f(x + \Delta x)-f(x) }{\Delta x} 

\] 


/'(x) 


lim 

Ax-»0 


/(x + Ax) - /(x) 
Ax 


9.4.6 Roots 

Roots are obtained using the command 
\sqrt[(order}] {(maths)} 

without the optional argument (order) it will produce a simple square root. 
Cubic roots etc can be obtained using the optional argument. 

Examples: 

1. A square root: 

\[ \sqrt{a+b} \] 


Va + h 


2. A cubic root: 

\[ \sqrt [3] {a+b} \] 


Input 


Input 

Output 


•f Input 


4- Input 


Output 


î Input 


i Input 

Output 


Définition 


Input 


Output 


Input 


Va + b 


Output 
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3. An nth root: 

\[ \sqrt [n] {a+b} \] 


y/a + b 

9.4.7 Mathematical Symbols 

Relational symbols are shown in Table 9.7. If you want a négation that is 
not shown, you can obtain it by preceding the Symbol with the command 
\not. For example: \not\subset produces the Symbol <ji. 


Table 9.7 Relational Symbols 


\approx 

s; 

\asymp 

x 

\bowtie 

DX 

\cong 

= 

\dashv 

H 

\doteq 

= 

\equiv 

= 

\frown 

— 

\ge or \geq 

> 

\gg 

» 

\in 

G 

\le or \leq 

< 

\11 

« 

\mid or | 

| 

\models 

|= 

\neq 


\ni 

G 

\notin 

t 

\parallel 

[] 

\prec 

-< 

\preceq 

< 

\perp 

1 

\propto 

oc 

\sim 


\simeq 

~ 

\smile 

— 

\sqsubseteq 

ç 

\sqsupseteq 

□ 

\subset 

C 

\subseteq 

ç 

\succ 

>- 

\succeq 

> 

\supset 

D 

\supseteq 

D 

\vdash 

h 




Binary operator symbols are shown in Table 9.8, and arrow symbols are 
shown in Table 9.9. There are also over and under arrows (Table 9.10) 
that hâve an argument. The over arrows put an extendible arrow over 
their argument, and the under arrows put an extendible arrow under their 
argument. In addition, the amsmath package provides extensible arrows that 
take a superscript and, optionally, a subscript: 

\xleftarrow [(subscript)] {(superscript)} 

\xright arrow [(su bscript ) ] { ( superscript) } 

Example: 


\[ 

A \xleftarrow{n+m-p} B \xrightarrow[X] {n+p} C 

\] 


A 


n+m —p 


B 


n+p _ 

-> C 

x 


Input 

Output 


[FAQ: Where can 
I find the symbol 
for ...] 


Définition 

Définition 


t Input 


i Input 


t Output 
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4- Output 


Table 9.8 Binary Operator Symbols 


\amalg 

II 

\ast 

* 

\bullet 

• 

\bigcirc 

O 

\bigtriangledown 

V 

\bigtriangleup 

A 

\cap 

n 

\cdot 

• 

\circ 

o 

\cup 

u 

\dagger 

f 

\ddagger 

i 

\diamond 

O 

\div 


\mp 

+ 

\odot 

0 

\ominus 

© 

\oplus 

© 

\oslash 

0 

\otimes 

0 

\pm 

± 

\setminus 

\ 

\sqcap 

n 

\sqcup 

U 

\star 

-k 

\times 

X 

\triangleleft 

<1 

\triangleright 

t> 

\uplus 

W 

\vee 

V 

\wedge 

A 

\wr 

1 




Table 9.9 Arrow Symbols 


\downarrow 

1 

\Downarrow 

4 

\hookleftarrow 

<— 5 

\hookrightarrow 


\leftarrow or \gets 

<- 

\Leftarrow 

4 = 

\leftharpoondown 


\leftharpoonup 


\leftrightarrow 

<-> 

\Leftrightarrow 

o 

\longleftarrow 

< - 

\Longleftarrow 

jL _ 

%- 

\longleftrightarrow 

<-> 

\Longleftrightarrow 


\longmapsto 

1-» 

\longrightarrow 

-> 

\Longrightarrow 

=*• 

\mapsto 

1—» 

\nearrow 


\nwarrow 

\ 

\rightarrow or \to 

—> 

\Rightarrow 


\rightharpoondown 

~Z 

\rightharpoonup 


\rightleftharpoons 


\searrow 

\ 

\swarrow 


\uparrow 

î 

\Uparrow 

\Updownarrow 

f 

$ 

\updownarrow 

I 


Symbols that can hâve limits are shown in Table 9.11. The size of these 
symbols dépends on whether they are in displayed maths or in-line maths. 

Example (Displayed Summation and Product): 

The limits of summations and products are placed above and below the 
Symbol in displayed maths: 


\[ 

f(x) = \sum_{i=l} A {n} x_i + \prod_{i=l} A {n} x_i 

\] 


■f Input 
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Table 9.10 Over and Under Arrows (Mefined by amsmath) 


Définition Example 

<- 

\overleftarrow{(mafhs)} \overleftarrow{ABC} ABC 

- > 

\overrightarrow{(mafhs}} \overrightarrow{ABC} ABC 

\overleftrightarrow{(mafhs)} T \overleftrightarrow{ABC} ABC 
\underleftarrow {(maths)Ÿ \underleftarrow{ABC} ABC 

\underrightarrow{(mafhs) A \underrightarrow{ABC} ABC 


\underleftrightarrow{(mafhs)A \underleftrightarrow{ABC} ABC 


Table 9.11 Symbols with Limits 


\sum 

E 

\int 

f 

\oint 


\prod 

n 

\coprod 

U 

\bigcap 

n 

\bigcup 

u 

\bigsqcup 

U 

\bigvee 

V 

\bigwedge 

A 

\bigodot 

O 

\bigotimes 

© 

\bigoplus 

© 

\biguplus 

l±J 




n n 

/(x) = £x f + fl Xi 

i=l i =1 

Example (In-line Summation and Product): 

The limits of summations and products are placed to the right of the Symbol 
in in-line maths: 


In a line of text: 

\begin{math} 

f(x) = \sum_{i=l} A {n} x_i + \prod_{i=l} A {n} x_i 
\end{math} 


In a line of text: /(x) = Ym=i x i + nr=i x i 

Multiline Sub- or Superscripts 

The amsmath package provides the command: 

\substack {(maths)} 

which can be used for multiline sub- or superscripts. Within the argument 
(maths) use \\ to separate rows. For example: 


\[ 

\sum_{ 


4- Input 

Output 

t Input 

4- Input 

Output 

Définition 

t Input 
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\substack 

{ 

i \in \mathcal{I}\\ 
i \neq ® 

} 

} 

x_i 

\] 


4- Input 



X; 


i s 9" 


ifO 


î Output 


4- Output 


9.4.8 Ellipses 

Ellipsis (omission mark) commands are shown in Table 9.12. The amsmath 
package also provides: \dotsc for dots with commas, \dotsb for dots with 
binary operators/relations, \dotsm for multiplication dots, \dotsi for dots 
with intégrais and \dotso for other dots, which can be used as replacements 
for \ldots and \cdots. 

Table 9.12 Ellipses (T provided by amsmath package) 

\vdots : \cdots • • • \dotsb^ • • • \dotsE •• • \dotsnE • • • 

\ddots \ldots ... \dotsc^ ... \dotso^ ... 

Example (Low Ellipsis): 

This example uses the command \forall to produce the "for ail" Symbol 
V, and it also uses V (backslash space) to make a space before the for ail 
Symbol. The amsmath "dots with commas" ellipsis \dotsc is used rather than 
the standard \ldots: 


1 t input 

\[ 

a_ix_i = b_i\ 1 _,\forall i = l,\dotsc, n 

\] 

i 4 Input 


djXf = b,- Vi = 1,..., n Output 

Example (Centred ellipsis): 

This example uses the amsmath "dots with binary operators/relations" \dotsb 
instead of the standard \cdots: 
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\[ 

y = a_l + a_2 + \dotsb + a_n 

\] 


y = + a 2 + ■■■ +a n 

Exercise 22 (Maths: Fractions and Symbols) 

This exercise uses a fraction, a square root, subscripts, superscripts and 
symbols. Try to reproduce the following output: 


The quadratic équation 

2 

x 1 = 0 

i=0 

has solutions given by 

-a t ± yof - 4a 2 a 0 


Again you can download or view the solution. 


9.4.9 Delimiters 

Placing brackets around a tall object in maths mode, such as fractions, does 
not look right if you use normal sized brackets. For example: 

i i 

\[ 

(\frac{l}{l+x}) 

\] 

i_i 

results in: 

( îtA 

Instead, you can automatically resize the delimiters using the commands: 

\left (délimiter) 

and 

\right (délimiter) 

Rewriting the above example: 


î Input 

i Input 

Output 


î Output 


4- Output 


t Input 

4- Input 

Output 

Définition 

Définition 
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\[ 

\left( \frac{l}{l+x} \right) 

\] 


produces: 

1 

1 + x 

Note that you must always hâve matching \left and \right commands, 
although the delimiters used may be different. If you want one of the delim- 
iters to be invisible, use a . (full stop) as the délimiter. Available delimiters 
are shown in Table 9.13. (Note for a vertical bar délimiter it's best to use 
amsmath's \lvert command instead of | and \lVert instead of \|.) Some- 
times using \left and \right doesn't produce the optimal sized delimiters. 
In which case you can use additional commands provided by the amsmath 
package shown in Table 9.14. 


Table 9.13 Delimiters (^defined by amsmath) 


( 

\{ 

\lVert’ 1 ’ 

\lfloor 

\uparrow 

\updownarrow 


( ) 

{ \ï 

[| \rVert 1 ’ 

[_ \rfloor 
î \downarrow 
| \Updownarrow 


) [ [ 

} \lvert 1 ’ | 

\langle ( 

J \lceil [ 

j \Uparrow f 

$ / / 


] ] 
\rvert’ 1 ’ j 
\rangle ) 
\rceil j 

\Downarrow JJ, 
\backslash \ 


Example (Vertical Bar Delimiters): 

\C 

\left\lvert 

\frac{l}{l+x} 

\right\rvert 

\] 


1 

1 + x 

Example (Délimiter with Subscript): 
Delimiters can take limits: 

\[ 

\left\lvert 

\frac{l}{l+x} 

\right\rvert_{x=®} 

\] 


t Input 


i Input 


Output 


t Input 


i Input 


Output 


t Input 


i Input 
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Table 9.14 Additional Commands Provided by amsmath for Délimiter Sizing 


Définitions Example 


Default Size 

$( X )$ 

(X) 

\bigl (delim) 

\bigr (delim) 

$\bigl( X \bigr)$ 

(X) 

\Bigl (delim) 

\Bigr (delim) 

$\Bigl( X \Bigr)$ 

(*: 

\biggl (delim) 

\biggr (delim) 

$\bigl( X \biggr) $ 

(* 

\Biggl (delim) 

\Biggr (delim) 

$\Biggl( X \Biggr) $ 

U 


1 


Example (Mismatch): 

The left and right delimiters don't hâve to match: 


Output 


1 1 Input 

\[ 

\left [\frac{l}{l+x}\right\rangle 

\] 

i 4- Input 


1 + X 


Output 


Example (An invisible délimiter): 

Every \right must hâve a matching \left (and vice versa), so use a . (full 
stop) for an invisible délimiter. 


1 1 î Input 

\[ 

\left . 

\frac{\partial f}{\partial x} 

\right\rvert_{x=Q} 

\] 

i i Input 


df 


dx 


z=0 


We hâve now covered enough to reproduce the équation shown in Chap¬ 
ter 1 (Introduction): 


Output 
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1 1 î Input 

\newcommand*{\pderiv}[2] {\frac{\partial #l}{\partial #2}} 

\newcommand* {\e }{\mathrm{ e }} 

\[ 

\pderiv{ A 2\mathcal{L}}{{z„i A \rho} A 2} = 

-\pderiv{\rho„i}{z„i A \rho} 

\left( 

\pderiv{v_i}{\rho_i} \frac{\e A {v_i}}{l-\e A {v_i}} 

+ v_i \frac{\e A {v_i}\pderiv{v_i}{\rho_i}(l-\e A {v_i}) 

+\e A {2v_i}\pderiv{v_i}{\rho_i}}{(l-\e A {v_i}) A 2} 

\right) 

\] 

i 4- Input 


rf X d Pi f dv i e'- e v,g( 1 _ e vt) + 

q z p z dz p yôpi 1 - e Vi + Vî (1 - e Vi ) 2 


t Output 


4- Output 


Note: 

The above code looks a bit complicated, and there are so many braces that 
it can be easy to lose track, so here are some ways of making it a little 
easier to type: 

1. Whenever you start a new environment type in the \begin and \end 
bits first, and then insert whatever goes inside the environment. This 
ensures that you always hâve a matching \begin and \end. The same 
goes for \[ and \]. 

2. Whenever you type any braces, always type the opening and closing 
braces first, and then insert whatever goes in between. This will ensure 
that your braces always match up. 

So keeping these notes in mind, let's try typing in the code in a method- 
ical manner: 

1. Start and end the displayed maths mode: 


1 1 t Input 

\[ 

\] 

I_I i Input 


2. We now need a partial dérivative. (The command \pderiv is defined 
as described earlier on page 153. Make sure you remember to define 
it, preferably in the preamble.) 
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1 1 î Input 

\[ 

\pderiv{}{} 

\] 

i i i Input 


3. Let's do the first argument. This partial dérivative is actually a double 
dérivative, which means we need a squared bit on the top along with 
a calligraphie L: 


1 1 t Input 

\[ 

\pderiv{ A 2 \mathcal{L}}{} 

\] 

I_I i Input 


4. The second argument is the z p squared bit. This is a nested superscript 
{z_i A \rho} A 2: 


1 1 t Input 

\[ 

\pderiv{ A 2 \mathcal{L}}{{z_i A \rho} A 2} 

\] 

, , t Input 


5. We can do the next partial dérivative in the same way. This one is 
slightly easier to do: 


1 1 t Input 

\[ 

\pderiv{ A 2 \mathcalL}{{z_i A \rho} A 2} = 

-\pderiv{\rho„i}{z = i A \rho} 

\] 

i i 4- Input 


6. Delimiters also need to occur in pairs, like curly braces and \begin 
and \end, so let's do them next: 


1 1 t Input 

\[ 

\pderiv{ A 2 \mathcal{L}}{{z_i A \rho} A 2} = 

-\pderiv{\rho_i}{z_i A \rho} 

\left( 

\right) 

\] 

l l i Input 
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7. Now we need to do the bits inside the brackets. First of ali we hâve 
yet another partial dérivative: 


1 1 t Input 

\[ 

\pderiv{ A 2 \mathcal{L}}{{z_i A \rho} A 2} = 

-\pderiv{\rho_i}{z_i A \rho} 

\left( 

\pder iv{v_i } {\rho_i } 

\right) 

\] 

i i i Input 


8. Now we hâve a fraction following the partial dérivative from the previ- 
ous step. (Make sure you use braces for the exponential bit: \e A {v_i} 
(e Vi ) is not the same as \e A v_i (ef). The command \e is defined as 
described earlier in Section 9.4.3. Make sure you define it, preferably 
in the preamble.) 


1 1 t Input 

\[ 

\pderiv{ A 2 \mathcal{L}}{{z_i A \rho} A 2} = 

-\pderiv{\rho_i}{z_i A \rho} 

\left( 

\pderiv{v_i}{\rho_i} \frac{\e A {v_i}}{l-\e A {v_i}} 

\right) 

\] 

, , i Input 


9. This is followed by v t times another fraction: 


1 1 t Input 

\[ 

\pderiv{ A 2 \mathcal{L}}{{z_i A \rho} A 2} = 

-\pderiv{\rho_i}{z_i A \rho} 

\left( 

\pderiv{v_i}{\rho_i} \frac{\e A {v_i}}{l-\e A {v_i}} 

+ v_i \frac{}{} 

\right) 

\] 

i i 4- Input 


10. The bottom part of the fraction (the denominator) is easier than the 
top, so let's do that first: 
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1 1 î Input 

\[ 

\pderiv{ A 2 \mathcal{L}}{{z_i A \rho} A 2} = 

-\pderiv{\rho_i}{z_i A \rho} 

\left( 

\pderiv{v_i}{\rho_i} \frac{\e A {v_i}}{l-\e A {v_i}} 

+ v_i \frac{}{(l-\e A {v_i}) A 2} 

\right) 

\] 

l l 4- Input 


11. Now for the top part of the fraction (the numerator). To refresh your 
memory, it should look like: 


e Vi |^(l - e Vi ) + e 2vi 
dpi 


ÔV[ 

dpi 


That's a bit complicated, so let's break it down: 


a) The first term is: 

\e A {v_i} 

b) The next term is another partial dérivative: 
\pder iv{v_i } {\rho_i } 

c) Then we hâve: 

(l-\e A {v„i}) 

d) Next we hâve to add on: 

+\e A {2v = i} 

e) And finally we hâve: 

\pder i v{v_i } {\rho_i } 


So the numerator is: 


1 1 t Input 

\e A {v_i}\pderiv{v_i}{\rho_i}(l-\e A {v_i}) 

+ \e A {2v_i}\pderiv{v_i}{\rho_i} 


4 Input 


Inserting this into our code: 
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1 1 t Input 

\[ 

\pderiv{ A 2\mathcal{L}}{{z_i A \rho} A 2} = 

-\pderiv{\rho_i}{z_i A \rho} 

\left( 

\pderiv{v_i}{\rho_i} \frac{\e A {v_i}}{l-\e A {v_i}} 

+ v_i \frac{\e A {v_i}\pderiv{v_i}{\rho_i}(l-\e A {v_i}) 

+\e A {2v_i}\pderiv{v_i}{\rho_i}}{(l-\e A {v_i}) A 2} 

\right) 

\] 


i Input 


9.4.10 Arrays 

Mathematical structures such as matrices and vectors require éléments to 
be arranged in rows and columns. Just as we can align material in rows and 
columns in text mode using the tabular environment (Section 4.6), we can do 
the same in maths mode using the array environment. The array environment 
has the same format as the tabular environment, however it must be in maths 
mode. The column half-gaps are given by the length register \arraycolsep 
(analogous to \tabcolsep). 

Example: 


\ r î Input 

\begin{array} {rrr } 

8 & 1 & 19\\ 

-6 & 10 & 200 
\end{array} 

\] 

!_! 4. Input 


t Output 

0 1 19 

-6 10 200 


4- Output 


Example (Adding Delimiters): 


1 t Input 

\[ 

\left( 

\begin{array}{rrr} 

0 & 1 & 19\\ 

-6 & 10 & 200 
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\end{array} 

\right) 

\] 


/ 0 1 19 \ 

\ -6 10 200 J 

Adding a Vertical Rule: 

A vertical rule can be added using | in the column spécifier. For example: 


\[ 

\left( 

\begin{array}{rr| r} 
0 & 1 & 19 \\ 

-6 & 10 & 200 
\end{array} 

\right) 

\] 


/ 0 1 19 \ 
\ -6 10 200 J 

Example (Cases): 

This example uses an invisible délimiter: 


\C 

f(x) = 

\left\{ 

\begin{array} {rl} 
-1 & x < 0\\ 

0 & x = 0\\ 

+1 & x > 0 
\end{array} 

\right . 

\] 


/(x) 


-1 x < 0 
0 x = 0 
+ 1 x > 0 


This can be rewritten more compactly using the amsmath cases environment: 


\[ 

f(x) = 

\begin{cases} 
-1 & x < 0\\ 


i Input 


Output 


t Input 


4- Input 

Output 


î Input 


i Input 


Output 


î Input 
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0 & x = ®\\ 
+1 & x > ® 
\end{cases} 
\] 


i Input 


-1 

x < 0 


0 

x = 0 

Output 

+1 

x > 0 



/(x) = 


The amsmath package provides some convenient environments to typeset 
matrices: pmatrix, bmatrix, Bmatrix, vmatrix and Vmatrix. These are similar to the 
array environment except there is no argument, and they add (respectively) 
(),[],{}, | | and || || delimiters. There is also the matrix environment that 
doesn't hâve any delimiters. 


Example: 


1 1 t Input 

\begin{ équation} 

\begin{pmatrix} 
a & b\\ 
c & d 

\end{pmatrix} 

\end{equation} 

I_I i Input 




t Output 


( 9 . 6 ) 


I_I i Output 

The amsmath package also provides the environment smallmatrix designed 
for in-line use. You need to add any delimiters explicitly. 

Example: 


1 t Input 

Here is a small matrix 
\begin{math} 

\left( 

\begin{ smallmatrix} 
a & b\\ 
c & d 

\end{ smallmatrix} 

\right) 

\end{math} 

in a line of text. 

I_I t Input 


Here is a small matrix ( “ % ) in a line of text. 


Output 
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9.4.11 Vectors 

A variable representing a vector can be typeset using the command: 
\vec{(variable }} 

Example: 

\[ \vec{x} \] 


£ 

Vectors are often typeset in bold. This can be done by redefining the 
\vec command. You could use \mathbf, for example: 


\renewcommand{\vec} [1] {\mathbf{#l}} 

\C 

\vec{x}\cdot\vec{\xi} = z 

\] 


X • £ = Z 

However, as you may hâve noticed, the Greek letter £ has not corne out 
in bold. Here's an alternative (using \boldsymbol defined in the amsfonts 

package): 


\renewcommand{\vec} [1] {\boldsymbol{#l}} 

\[ 

\vec{x}\cdot\vec{\xi} = z 

\] 


X • £ = z 

Located (or position) vectors, on the other hand, are usually typeset with 
a right arrow, but the default définition of \vec produces an arrow that is 
too small: 

\[ \vec{OP} \] 


OP 

Instead, use \overrightarrow (Table 9.10): 

\[ \overrightarrow{OP} \] 

OP 

You might prefer to define separate commands for a located vector and a 
vector variable. 


Définition 

Input 

Output 

■f Input 

i Input 

Output 

î Input 

i Input 

Output 

Input 

Output 

Input 

Output 
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Example: 

In the preamble, define \lvec for a located vector and \bvec for a vector 
variable: 


\newcommand*{\lvec} [1] {\overrightarrow{#l}} 
\newcommand*{\bvec} [1] {\boldsymbol{#l}} 

Later in the document: 

Let $\bvec{u}=(x, y)$ represent $\lvec{OP}$, then 

\[ 

\lVert \bvec{u} \rVert = \sqrt{x A 2 + y A 2} 

\] 


Let u = (x,y) represent OP, then 

[|u [| = V * 2 + y 2 


Exercise 23 (Maths: Vectors and Arrays) 

Try to produce the following: 


Ax = 





= y 


As before, you can download or view the solution. 


9.4.12 Mathematical Spacing 

ETgX deals with mathematical spacing fairly well, but sometimes you may 
find you want to adjust the spacing yourself. Available spacing commands 
are listed in Table 9.15. 

Exercise 24 (More Mathematics) 

This exercise uses the spacing command \qquad. In addition, it has a 
function name, diag, and it uses the \forall and ellipses symbols. It also 
redefines the \vec command, as was done in the previous section, uses the 
bmatrix environment (see Section 9.4.10), and has subscripts and superscripts. 
Try to reproduce the following output: 


"1" Input 


4- Input 


t Input 


4- Input 


t Output 


4- Output 


t Output 


4- Output 
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Table 9.15 Mathematical Spacing Commands fprovided by amsmath) 


Command 

Example Input 

Example Output 


$AB$ 

AB 

\thinspace or \, 

$A\,B$ 

AB 

\medspace T or \: 

$A\:B$ 

AB 

\thickspace^ or \; 

$A\;B$ 

A B 

\quad 

$A\quad B$ 

A B 

\qquad 

$A\qquad B$ 

A B 

\negthinspace or \! 

$A\!B$ 

AB 

\negmedspace^ 

$A\negmedspace B$ 

AB 

\negthickspace^ 

$A\negthickspace B$ 

AB 


1 

The set of linear équations: 



1 t Output 

dfXi = bf 

Vf = 1,.. 

. ,n 


can be written as a matrix équation: 



diag(a)x = b 



where x = (xi,... ,x n ) T , b = (b 1; . 

. ,b n ) T and 




CLi 0 

0 ‘ 


diag(a) = 

0 a 2 

0 


1_ 

0 ••• 0 

o. n 

1 4- Output 


Again, you can download or view the solution. 
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Defining Environments 


Just as you can define new commands, you can also define new environ¬ 
ments. The command 

\newenvironment {(env-name)} [(n-args)] [( default }] {( begin-code)}{(end- 
code)} 

is used to define a new environment. As with new commands, you can use 
the optional argument ( n-args } to define an environment with arguments, 
and ( default } to define an environment with an optional argument. 

The first argument ( env-name } is the name of your new environment. 
Remember that the environment name must not hâve a backslash. The 
mandatory arguments ( begin-code ) and ( end-code } indicate what 
should do at the beginning and end of the environment. Note that although 
(begin-code) can reference the arguments using #1 etc, the ( end-code ) part 
can't. 

Example (An Exercise Environment): 

Let's first consider an example of an environment without any arguments. 
Let's make an environment called, say, exercise that prints Exercise in bold 
and typesets the contents of the environment in italic, with a gap between 
the title and the contents. In other words, we want the following code: 


\begin{ exercise} 
This is a sample. 
\end{exercise} 


to produce the following output: 


Exercise 
This is a sample. 


(In the next chapter we will add numbering.) 

Let's first consider what we want this environment to do: we can get the 
word "Exercise" in bold using \textbf, and the italic font can be obtained 
by using the itshape environment (recall Section 4.5). So, at the start of our 
new environment we need 

\textbf {Exercise }\begin{itshape} 


Définition 


t Input 


4- Input 


t Output 


4 Output 


Input 


172 
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and at the end of our new environment we need to end the itshape environ¬ 
ment: 

\end{itshape} 

Putting the above together into the new environment définition: 

i i 

\newenvironment{exercise}% environment name 
{% begin code 

\textbf{Exercise}\begin{itshape}% 

}% 

{\end{itshape}}% end code 


Let's try it out: 


\begin{exercise} 
This is a sample. 
\end{exercise} 


Exercise This is a sample. 

Not quite right. Let's put a paragraph break after Exercise, and put one 
before it as well. The command \par can be used to make a paragraph 
break and the extra bit of vertical spacing can be produced using \vspace. 
The length \baselineskip is the interline spacing. Modifications are shown 
in bold like this. 


\newenvironment{exercise}% environment name 
{% begin code 

\par\vspace{\baselineskip}% 

\textbf{Exercise}\begin{itshape}% 

\par\vspace{\baselineskip}% 

}% 

{\end{itshape}}% end code 


Let's hâve a look at the output now: 


Exercise 
This is a sample. 


The indent at the start of each line is caused by the normal paragraph 
indentation. This can be suppressed using \noindent. It's also a good 
idea to suppress any spaces immediately following \begin{exercise} and 
\end{exercise}, which can be done using \ignorespaces and 
\ignorespacesafterend. Modifications are again shown in bold like this. 


Input 

t Input 

4. Input 

t Input 

4- Input 

Output 


t Input 


i Input 

t Output 

4 Output 

[FAQ: There's a 
space added after 
my environment] 
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\newenvironment{exercise}% environment name 
{% begin code 

\par\vspace{\baselineskip}\noindent 

\textbf{Exercise}\begin{itshape}% 

\par\vspace{\baselineskip}\noindent\ignorespaces 

}% 

{% end code 

\end{it shape } \ignorespacesaf terend 

} 

The exercise environment now appears as: 


Exercise 
This is a sample. 


Now let's modify our code so that the environment takes an argument. 
The argument should indicate the exercise topic. For example, the following 
code: 


\begin{exercise}{An Example} 
This is a sample. 
\end{exercise} 


should produce the following resuit: 


Exercise (An Example) 
This is a sample. 


As with \newcommand, #1 is used to indicate the first argument. We can now 
modify the code as follows: 


\newenvironment{exercise} [1]% environment name 
{% begin code 

\par\vspace{\baselineskip}\noindent 
\textbf{Exercise (#1) }\begin{itshape}% 
\par\vspace{\baselineskip}\noindent\ignorespaces 

}% 

{% end code 

\end{itshape}\ignorespacesafterend 

} 


t Input 


4- Input 


t Output 


4 Output 


t Input 


4 Input 


t Output 


4 Output 


t Input 


4 Input 
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10.1 Redefining Environments 


It is also possible to redefine an environment using: 

\renewenvironment {(env-name)} [( n-args )] [(default)} {( begin-code }} 
{(end-code)} 


Définition 


As with \renewcommand, only redefine an existing environment if you want 
a modified version of that environment rather than because you like the 
environment name. 


Exercise 25 (Defining a New Environment) 

If you did any of the exercises from Exercise 10 to Exercise 17, go back 
to the document you created and define the exercise environment as in the 
example above. Then try creating some exercises using this environment. 
You could, maybe, put an exercise in the first chapter, and then another one 
in the second chapter. Again you can download or view an example. 



Chapter 11 


COUNTERS 


As we hâve seen, ETjrX automatically generates numbers for chapters, sec¬ 
tions, équations etc. These numbers are stored in counters. The names of 
these counters are usually the same as the name of the object with which 
it is associated but without any backslash. For example, the \chapter com- 
mand has an associated counter called chapter, the \footnote command has 
an associated counter called footnote, the équation environment has an associ¬ 
ated counter called équation, the figure environment has an associated counter 
called figure and the table environment has an associated counter called table. 

There is also a counter called page that keeps track of the current page 
number. 

The value of a counter can be displayed using the command 

\the(cOUnfer) Définition 

where ( counter } is the name of the associated counter. Note that (counter) 
does not go in curly braces and adjoins \the (for example, \thepage, 
\thesection or \thechapter). In fact, we hâve already encountered 
\thefigure in Section 7.4. 

Example: 


1 t Input 

This page is Page~\thepage . 

The current chapter is Chapter~\thechapter . 

i 4 Input 


This page is Page 176. The current chapter is Chapter 11. Output 

New counters can be created using the command: 

\newcounter {(counter-name)} [( outer-counter }] Définition 

The mandatory argument ( counter-name } is the name of your new counter 
(no backslash in the name). For example, let's define a counter called 
exercise to keep track of each exercise. (Recall the exercise example from 
Chapter 10 (Defining Environments).) 

\newcounter {exercise} nput 

We can now display the value of the counter using the command \theexercise. 

At the moment the counter has the value zéro, the value can be changed 
using one of the following commands: 


[FAQ: Page 
number is wrong 
at start of page] 
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\stepcounter{(counfer}} Incréments ( counter) by 1 

\refstepcounter{(counfer}} As above, but allows you to cross- 

reference the counter using \label and 
\ref 

\setcounter{(counfer)}{(num}} Sets the counter to ( num) 
\addtocounter{(counfer)}{(num}} Adds (num) to (counter) 

A couple of the commands above take a number (num) as one of the 
arguments. If you want to use another counter for this argument, you need 
to use 

\value { ( counter } } 

For example, if you want to set our new exercise counter to the same value 
as the page counter, you would do 

\setcounter{exercise}{\value{page}} 

Let's go back to the exercise environment you created in Exercise 25. The 
exercises really ought to hâve an associated number, and this number should 
be incremented each time we use the exercise environment. So let's modify 
our code to do this. Modifications are illustrated in bold like this: 


\newcounter{exercise} 

\newenvironment{exercise} [ 1 ]% environment name 

{% begin code 

\par\vspace{\baselineskip}\noindent 

\refstepcounter{exercise}% 

\textbf {Exercise \theexerciseV,(#l ) }% 
\begin{itshape}% 

\par\vspace{\baselineskip}% 

\noindent\ignorespaces 

}% 

{% end code 
\end{itshape}% 

\par\vspace{\baselineskip}% 

\noindent\ignorespacesafterend 

} 


Note that the counter needs to be incremented before it is used. I've also 
added an extra \vspace at the end of the environment and a paragraph 
break. Since we've used \refstepcounter instead of \stepcounter we can 
cross-reference our exercise environment: 


Définition 


Input 


t Input 


i Input 
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Exercise~\ref{ex : simple} is a simple exercise. 

\begin{ exercise}{Simple Exercise} 

\label{ex :simple}% 

This is a simple exercise. 

\end{exercise} 


This produces the following output: 


Exercise 1 is a simple exercise. 
Exercise 1 (Simple Exercise) 
This is a simple exercise. 


The counter représentation can be changed by redefining \theexercise 
using the \renewcommand command described in Section 8.2. The following 
commands can be used to display the counter: 


\arabic{(counfer}} 
\Roman { ( counter ) } 
\r oman { ( counter ) } 
\alph {(counter)} 
\Alph{ (counter)} 


Arabie numéral (1, 2 , 3 , ...) 

Upper case Roman numéral (I, II, III, ... ] 
Lower case Roman numéral (i, ii, iii, ... ) 
Lower case letter (a, b, c, ..., z) 

Upper case letter (A, B, C, ..., Z) 


\fnsymbol{ (counter)} A footnote Symbol (* f t § H Il ** tt H) 


Example: 

To make the chapter numbers appear as upper case Roman numerals you 
would do: 

\renewcommand{\thechapter}{\Roman{chapter}} 

You may hâve noticed that \newcounter has an optional argument (outer- 
counter). This is for use if you require the new counter to be reset every 
time ( outer-counter) is incremented. For example, the section numbers in 
the serbook class are dépendent on the chapter numbers. Each time a new 
chapter is started, the section numbers are reset. Suppose we want our 
exercise counter to be dépendent on the chapter counter, we would do 

\newcounter{exercise} [chapter] 

Note that if you make a counter dépendent on another counter like this, 
the default action of \the(counfer) remains the same, so \theexercise 


t Input 


4- Input 


t Output 


J, Output 

[FAQ: Redefining 

counters' 

\the-commands] 


Input 


[FAQ: Master and 
slave counters] 


Input 
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won't print the chapter number. To make the chapter number appear as 
well, we need to redefine \theexercise (recall Section 8.2): 

\renewcommand{\theexercise}{\thechapter . \arabic{exercise}} 

Notice the use of \thechapter instead of, say, \arabic{chapter}. This way 
we don't need to keep track of the chapter counter format. 

Example (Footnote Markers): 

The footnote counter is reset at the start of each chapter but by default the 
chapter number isn't displayed in \thefootnote. In this book \thefootnote 
was redefined so that it displays the chapter number: 

\renewcommand{\thefootnote}{\thechapter . \arabic{footnote}} 

Exercise 26 (Using Counters) 

Modify the document from Exercise 25 so that the exercise environment 
has a counter. Make the counter dépendent on the chapter. You can down¬ 
load or view an example. 


Input 


Input 



Appendix A 

Downloading and Installing 

Packages 


New ETgX packages are being created ail the time, so you may find that 
there are sortie packages that you don't hâve on your installation. In this 
case, if you don't hâve the package you want, you can download it from 
CTAN [1]. Before discussing installing new packages, it is a good idea for 
you to understand the TgX Directory Structure (TDS). 

Ail the files that make up the TgX distribution are stored in a standard 
hierarchical structure. The root directory of the main distribution is usu- 
ally called texmf or texmf-dist. Its location dépends on your System. For 
example, if you are using TeX Live 2012 on UNIX/Linux, it will probably be 
located in /usr/local/texlive/2®12/texmf-dist or if you are using MiKTeX 
it may be located in c:\texmf or c:\Program Files\texmf. Whichever Sys¬ 
tem you are using, I shall refer to this directory as (TEXMF). So, if you 
are using TeX Live 2012, (TEXMF) /doc refers to the directory /usr/local/ 
texlive/2012/texmf-dist/doc, or if you are using MiKTeX, (TEXMF)\ doc 
refers to the folder c:\texmf\doc or c:\Program Files\texmf\doc. In gen¬ 
eral, you should not make any modifications to the (TEXMF) directory tree 
as it will get overridden whenever you update your TgX distribution. 

You should also hâve a local texmf tree. Again, the location of the local 
texmf tree dépends on your System. If you are using TeX Live, it may 
be /usr/local/texlive/texmf-local. If you are using MiKTeX, it may be 
c:\localtexmf or c:\Program Files\localtexmf. Whichever System you 
are using, I shall refer to this directory as (TEXMF-LOCAL). There is 
also the (TEXMF-HOME) directory. On UNIX-like Systems this is usually 
~/texmf. On Windows it's usually in your user folder. This is the one where 
you typically install any new classes or packages. 

These directories must ail hâve the same structure. The principle sub- 
directories relating to ETj;X are illustrated in Figure A.l. It may be that your 
(TEXMF-HOME) directory doesn't exist or doesn't contain some of these 
sub-directories, if so, you will need to create them. 

You can use the kpsewhich application to find out the locations of (TEXMF- 
LOCAL) and (TEXMF-HOME). Since kpsewhich is a command-line appli¬ 
cation, you will need a command prompt or terminal open (see Section 2.5). 
At the command prompt, type 


[FAQ: Installing 
things on a 
(La)TeX System] 

[FAQ: Installation 
using MiKTeX 
package 
manager] 

[FAQ: What is 
the TDS?] 


kpsewhich -var-value=TEXMFHOME 
to display the location of (TEXMF-HOME) or 
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kpsewhich -var-value=TEXMFLOCAL 

to display the location of ( TEXMF-LOCAL). (Remember to press the enter 
1 key at the end of the line.) 

The documentation for ETgX classes and packages can be found in the 
doc/latex sub-directories: (TEXMF)/ doc/latex, (TEXMF-LOCAL) /doc/ 
latex and (TEXMF-FIOME)/ doc/latex. 


— bib 


— bibtete- 


texmf- 


— bst 
— doc— latex 


— tex— latex 


Figure A.l The Directory Structure (TDS) Showing the Main ET|tX- 
Related Sub-Directories. 


Some packages are supplied in this format.^ 1 For example, the package 
sample-package may be distributed in a compressed file sample-package. tds. zip, 
which contains the files 

doc/latex/sample-package/sample-package.pdf 
tex/latex/sample-package/sample-package.sty 
tex/latex/sample-package/sample-foo.sty 
tex/latex/sample-package/sample-bar.sty 

In this case ail you need to do is decompress the contents of the archive 
into the (TEXMF-LOCAL) or (TEXMF-HOME) directory. 

On older TgX-distributions, you would then need to refresh the TgX 
database (described in Section A.2 on page 183). With new distributions, 
you don't need to do this if you are installing a new package into your 
(TEXMF-HOME) directory. 

Example (Unix-Like): 

To install sample-package.tds.zip (assuming you're in the same directory 
as that file): 

unzip -d ~/texmf sample-package.tds.zip 


A.l DTX and INS Files 

Not ail packages are provided in the TDS [14] format. Instead (or addi- 
tionally) many are supplied with the code and documentation ail bundled 
together in one file. This file usually has the extension . dtx, and it usually 
cornes with an installation script that has the extension . ins. Once you hâve 
downloaded the . dtx and . ins files, you will then hâve to extract the code 
before you can use it. Let's go back to the previous example. The package 


[FAQ: 

Documented 
LaTeX sources 
(.dtx files)] 


A1 Complete list at http://mirror.ctan.org/install/macros/latex/contrib/. 
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sample-package is now distributed in a DTX file, so the sample-package.zip 
archive contains the files 

sample-package.dtx sample-package.ins 

(with hopefully a README or INSTALL file). Note that this archive, unlike the 
TDS one, doesn't contain any . sty files. The documentation source and the 
package code (sample-package.sty, sample-foo.sty and sample-bar.sty) 
are ail contained in the file sample-package. dtx. This is how to extract 
them: 

1. Extract the contents of sample-package.zip to a temporary directory. 

2. Run ETgX on the file sample-package. ins. If you are using a terminal, 
you can type the following at the command prompt: 

latex sample-package.ins 

If you are using a front-end, such as TeXWorks, open the . ins file (for 
example sample-package. ins), and click on the build/typeset button. 

This will create the files containing the package code. In this example 
it will create the main package file sample-package. sty and supple- 
mentary packages sample-foo. sty and sample-bar. sty. 

3. Make a sub-directory of (TEXMF-LOCAL)/ tex/latex A2 in which to 
place these files. In this example, the package is called "sample-package", 
so make a sub-directory called sample-package. 

4. Move the files created in Step 2 into the new sub-directory you created 
in the previous step. 

5. Run PDFETgX on the file sample-package.dtx. (The same as in Step 2, 
but use the file sample-package.dtx instead of sample-package. ins.) 
This will create a file called sample-package.pdf. You may need to re- 
peat this step to ensure that the cross references are up-to-date. Check 
the README file or INSTALL file to see if there is anything else you need 
to do. (If you hâve downloaded the package from CTAN, it's possible 
that the documentation has already been supplied, as package authors 
are encouraged to supply a PDF version of the documentation for on¬ 
line viewing. If so, you can omit this step.) 

6. Make a sub-directory of (TEXMF-LOCAL)/ doc/latex A3 in which to 
place the documentation. In this example, the package is called "sample- 
package", so make a sub-directory called sample-package. 

7. Move the files created in Step 5 into the new sub-directory you created 
in the previous step. 

As mentioned above, on older TgX-distributions, you would then need to 
refresh the TgX database, but this isn't required for (TEXMF-HOME) installs 
on new distributions. 

A.2 or (TEXMF-LOCAL)\ tex\latex on Windows 
A3 or (TEXMF-LOCAL)\ doc\latex on Windows 
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A.2 Refreshing the T^X Database 

On older T^X distributions you had to refresh the T^X database whenever 
you installed new classes or packages. With newer installations you don't 
need to do this if you install them in your ( TEXMF-HOME) directory, except 
under certain circumstances (for example, you're using using a networked 
drive). If it turns out that TgX can't find a new class or package you hâve 
installed in ( TEXMF-HOME ) you will need to update the database using the 
texhash (or mktexlsr) application. This is a command-line application, so 
you need a terminal or command prompt (see Section 2.5). 

For example, on UNIX/Linux, to update ( TEXMF-HOME } (the directory 
~/texmf) you need to type the following at the command prompt: 

texhash ~/texmf 

If you are using a modem T£X distribution, such as MiKTeX, TeX Live or 
MacTeX there should be a package manager that has a package installation 
and refresh facility. For example, TeX Live cornes with the TeX Live Man¬ 
ager (tlmgr or mactlmgr) and recent versions of MiKTeX hâve an application 
called MiKTeX Update Wizard which can automatically download and install 
known packages. 

If you expérience any problems, contact your System administrator for 
help or try one of the resources listed in Appendix C (Need More Help?). 

Related UK FAQ [ 18 ] topics: 

• Installing things on a (La)TeX System 

• Installing files "where (La)TeX can find them" 

• Installation using MiKTeX package manager 

• "Temporary" installation of (La)TeX files 

• "Private" installations of files 


Appendix B 

COMMON ERRORS 


• If you're running ETgX from a terminal and the only message that gets 
displayed is: 

latex: Command not found. 

or 

Bad command or file name 

then you hâve either mistyped the command name, or you don't hâve 
ETgX installed on your computer, or your path hasn't been set up cor- 
rectly. First check that you hâve typed the command correctly, then 
check to see if you hâve TgX installed. Failing that, contact your System 
administrator for help or try one of the resources listed in Appendix C 
(Need More Help?). 

• If you're running ffl^X from a terminal and you get the message (or 
something similar): 

This is TeX, Version 3.14159 (Web2C 7.3.1) 

! I can’t find file ‘sample’. 

<*> sample 

Please type another input file name: 

then you hâve either misspelt the filename or you are in the wrong 
directory. If you hâve misspelt the filename, simply type in the correct 
name at the prompt. If you are in the wrong directory or you want to 
quit, type X followed by the return character <«— 1 . To check you are in 
the right directory, on a Unix-like System you can type: 

ls 

This will list the contents of the directory. If you are certain that you 
hâve spelt the filename correctly and that you are in the right directory, 
there may be something wrong with your path, in which case contact 
your System administrator. 

• Error messages will usually look something like: 


184 


Appendix B Common Errors 


185 


! Undefined control sequence. 

1.1 \docmentclass 

[12pt]{scrartcl} 

? 


The first line is the error message. In this example I hâve misspelt the 
command \documentclass. The next line begins with 1. followed by 
a number. This is the line number in the source code where the error 
occurred. In this case the error occurred on line 1. Following the line 
number is the input line ET E X has processed so far, and staggered on 
the next line is the remainder of the input line. 

Here's another example. Suppose line 8 of my source code looks like: 
The date today is: \toady, which is nice to know. 


The error in this case is the misspelling of the command \today. The 
error message will appear as follows: 


-Error Message 


! Undefined control sequence. 
1.8 The date today is \toady 


Line 
Number 


Error" 
FTpX prompt 


, which is nice to know.-- 

This is how far ET E X has got 


Rest of 
the line 


At the ET E X prompt, you can either type h for a help message, or type 
x to exit ET E X and go back to your source code and fix the problem. 


There follows below a list of common error messages. If your problem 
isn't listed there, try the UK FAQ [18]. 


B.l * (No message, just an asterisk promptï) 

You've gone into T^X! This is probably because you've forgotten the \end 
{document}. The asterisk is the T E X prompt. At this point the best thing to 
do is to abort the T E X run. 


B.2 Argument of \cline has an extra } 

If this error occurred on the first line in your tabular environment, you may 
hâve forgotten the argument to the tabular environment. 


B.3 Argument of \muIticoIumn has an extra } 

If this error occurred on the first line in your tabular environment, you may 
hâve forgotten the argument to the tabular environment. 
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B.4 \begin{... } ended by \end{... } 

The beginning of your environment doesn't hâve a matching end. 

• Check to make sure you hâve spelt the name of the environment cor- 
rectly. 

You will get this error message if you do, say, 

\end{docment} 
instead of 
\end{document} 

• Check that for every \begin you hâve a corresponding \end with the 
same name. 


B.5 Bad math environment délimiter 

Only a certain type of character may be used as a délimiter (for example, 
( ) [ ] ), check which one you hâve specified. This error may also occur if 
you hâve forgotten a \right or not used it in the same scope. (Remember 
to use a . if you want an invisible délimiter) or you may hâve forgotten to 
end your array environment with \end{array}. 


B.6 Can only be used in preambïe. 

Some commands, such as \usepackage may only appear in the preambïe. 
Check to see where you hâve put it. For example, this error will be caused 
by doing: 

\documentclass{scrartcl} 

\begin{document} 

\usepackage{graphicx} 
instead of 

\documentclass{scrartcl} 

\usepackage{graphicx} 


\begin{document} 
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B.7 Command ... already defined 

You hâve tried to define a command which already exists. Try giving it a 
different name. Remember never to redefine a command if you don't know 
what the command originally does. 

Alternatively, you hâve tried to define an environment which already 
exists. Give the new environment a different name. Again, never redefine 
an environment where you don't know what the original environment does. 


B.8 Display math should end with $$ 

You may hâve a dollar sign ($) in a displayed maths environment, such as the 
équation environment. Remember that $ is short hand for \begin{math} or 
\end{math}, so you can't end one of the other environments with a $. (This 
error message is in fact a bit confusing, as it seems to be suggesting that 
you end a displayed maths environment with $$ which you also shouldn't 
do.) [FAQ: Why use 

\ [... \] in place 

of $$... $$] 

B.9 Environment ... undefined 

ETgX doesn't recognise the environment you hâve specified. 

• Check you hâve spelt the environment name correctly. 

You will get this error if you do, say, 

\begin{docment} )C 

instead of 

\begin{document} 

• If it's your own environment, check you hâve defined the environment 
before using it. 

• If the environment is defined in a package, check you hâve included 
the package using the \usepackage command. 


B. 10 Extra alignment tab has been changed to 

\cr 

You hâve too many ampersands (&) in one row. The most probable cause 
is that you hâve forgotten the end of row command \\ on the previous 
row. Remember also that if you hâve a \multicolumn command to span 
more than one column, you should hâve fewer &s in that row. This error 
can also occur from a confusion over the two meanings of \\: a line break 
within a paragraph cell and a row break. In which case, you need to use 
\tabularnewline instead of \\. 
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B. 11 Extra \right 

There are a number of possible causes. The most probable is that you hâve 
a \right that doesn't hâve a matching \left. (Remember left cornes before 
right.) Another possible cause is that you hâve missed out \end{array}. 
(Remember that environments provide implicit grouping, and \left and its 
matching \right must appear within the same group level.) 


B.12 File ended while scannmg use of ... 

The most usual cause of this error is a missing closing brace. 
You will get this error if you do, say, 

\end{document 

instead of 

\end{document} 


B.13 File not found 

ETp;X can't find the file you hâve specified. You will be given the opportunity 
to type in the correct filename at the prompt. If you want to quit, simply 
type X followed by the return character . 

• Make sure that you hâve spelt the filename correctly. 

This error will be caused by, say, 

\documentclass{scr article} 

instead of 

\documentclass{scrartcl} 

If this is the case, simply type in the correct name at the prompt (fol¬ 
lowed by the return character ◄— 1 ) then go back and fix the spelling in 
the source code. 

• Make sure that the file is in the same directory as your document or 
in the ffl^X path. If the file is in another directory (not in the RI^X 
path), you will need to specify the pathname, but remember that when 
using BTjrX under Windows, you need to use a forward slash (/) as the 
directory divider, as a backslash would be interpreted as a command. 
For example, if you hâve a file called shapes.pdf in the subdirectory 
pictures then you would get a "file not found" error message if you 
did 


\includegraphics{shapes} 
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instead of 

\includegraphics{pictures/shapes} 

• If the file is a package or class file, it's possible that you don't hâve 
that file installed on your computer. If this is the case you will need to 
download and install it as described in Appendix A (Downloading and 
Installing Packages). Remember that you need to refresh the database 
after installing a new package or class file. 


B.14 Illégal character in array arg 

You hâve used a character in the argument of a tabular or array environment 
that is not allowed. The standard available characters are: r (right justified), 
1 (left justified), c (centred) and p, as well as @{(inter-col text }}. Remember 
that if you want to use the >{(decl }} or <{(decl )} specifiers, you must include 
the array package. 

This error will also occur if you hâve forgotten the argument to the 
tabular or array environment. 


B.15 Illégal parameter number in définition 

You hâve referred to a parameter (argument) number that is greater than 
the number of parameters you hâve specified. For example, suppose you 
defined the command to hâve only one parameter, then you can't use #2 
which refers to the second, non-existent, parameter. Remember that you 
need to specify how many parameters you want in the optional argument 
to \newcommand, otherwise it will be assumed that the command has no 
arguments. 


B.16 Illégal unit of measure (pt inserted) 

You hâve either not specified a unit when giving a length (even zéro lengths 
must hâve a unit) or you hâve specified an invalid unit or you hâve misspelt 
the unit. Available units are listed in Table 2.1. 


B.17 Lonely \item 

The command \item may only appear in one of the list making environ- 
ments (such as itemize). Make sure you haven't forgotten your environment. 


B. 18 Misplaced alignment tab character & 

You hâve used the spécial character & where you shouldn't hâve. Recall 
from Section 4.3 that if you want an & sign to appear you need to do \& not 
just &. 
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You would hâve got this error message if you had done, say, 
& our equipment 
instead of 
\& our equipment 


B.19 Missing } inserted 

You hâve missed a closing curly brace, or you may hâve missed out an 
argument. 

Example: 

If the following line occurs in a tabular environment: 

& \multicolumn{2 }{c}\\ 

this will produce the error. (The third argument to \multicolumn has been 
omitted.) 


B.20 Missing $ inserted 

This message can be caused by a number of errors: 

• You might hâve missed the beginning of one of the mathematics en- 
vironments (that is, you've used a command that must only appear in 
maths mode). 

• You may hâve typed $ instead of \$ (you actually want a dollar Symbol 
to appear). Recall from Section 4.3 that if you want a $ sign to appear 
you need to do \$ not just $. 

You would hâve got this error message if you had done, say, 
expenditure came to $2000.00 
instead of 

expenditure came to \$2000.00 

• You may hâve missed the end of a mathematics environment, or you 
may hâve a paragraph break within an in-line or displayed maths en¬ 
vironment, where it is not permitted. Make sure you don't hâve any 
blank lines within the environment. If you want a blank line in your 
code to make it easier to edit, try having a percent sign at the start of 
an empty line to ensure that the line is ignored by ET^X. For example: 

\begin{ équation} 

% 

E = mc A 2 

% 

\end{equation} 


Appendix B Common Errors 


191 


B.21 Missing \begin{document} 

You hâve put some text outside of the document environment. Check the 
following: 

• You hâve remembered \begin{document} 

This error would be caused by, say, 

\documentclass{scrartcl} 

This is a simple document 
instead of 

\documentclass{scrartcl} 

\begin{document} 

This is a simple document. 

• You haven't placed any text before \begin{document}. For example: 
\documentclass{scrartcl} 


This is a simple document 
\begin{document} 

instead of 

\documentclass{scrartcl} 


X 


\begin{document} 

This is a simple document 


✓ 


• You haven't missed out the backslash at the start of either \documentclass 
or \begin{document} 

This error would be caused by, say, 

documentclassfscrartcl} X 

instead of 

\documentclass{scrartcl} 


B.22 Missing délimiter 

You hâve forgotten to specify the type of délimiter you want (for example, 
() [ ] \{ \}). (Remember to use a . if you want an invisible délimiter, 
and remember that if you want a curly brace, you must hâve a backslash 
followed by the curly brace.) 
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Example: 

This error will occur if you do, say, 

f(x) = \left{ 

\begin{array}{ll} 

Q & x \leq Q\\ 

1 & x > 1 
\end{array} 

\right . 

instead of 

f(x) = \left\{ 

\begin{array}{ll} 

Q & x \leq Q\\ 

1 & x > 1 
\end{array} 

\right . 


B.23 Missing \endcsname inserted 

This is a error rather than a ETgX error which makes it harder to 
détermine the cause, however it can be caused by placing a backslash in 
front of the name of an environment. (Remember that environment names 
do not contain a backslash.) 

This error will be caused by, say, 

\begin{\sffamily} 

instead of 

\begin{sffamily} 


B.24 Missing \endgroup inserted 

A number of things could hâve caused this. You may hâve missed out the 
end of an environment, or you may hâve an environment inside of another 
environment it's not allowed to be in. For example, this error can be caused 
by placing an eqnarray environment inside a displaymath environment, which 
is not allowed. (But, of course, you haven't used either of those obsolète 
environments [15], hâve you?) 


B.25 Missing number, treated as zéro 

ETj;X is expecting a number. If your command takes more than one ar¬ 
gument, check to make sure the arguments are in the correct order. For 
example, if you are using a minipage environment, you might hâve omitted 
the mandatory argument which spécifiés the width of the minipage, or you 
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may hâve the optional arguments the wrong way round. The placement 
spécifier should corne first, followed by the height. 

If you are using \addtocounter or \setcounter remember that the sec¬ 
ond argument must be a number, so if you want the value of a counter as 
the argument you must use \value. This error can be caused by, say, 

\setcounter{exercise}{chapter} 

instead of 

\setcounter{exercise}{\value{chapter}} 


B.26 Paragraph ended before \begin was 
complété 

You've probably missed a closing brace at the end of the argument to \begin. 
This error will be caused by, say, 

\begin{document 

instead of 

\begin{document} 


B.27 Runaway argument 

There are a number of possible causes of this error: 

• Paragraph breaks are not permitted in the arguments of short com- 
mands. If there is a corresponding environment then you should use 
that instead. For example, this error message will be generated by 
doing, say, 

\textbf{This is a simple document. 

Here is the first paragraph. 

Here is the second paragraph.} 

instead of 

\begin{bf sériés} 

This is a simple document. 

Here is the first paragraph. 

Here is the second paragraph. 

\end{bfseries} 

• The closing brace of a mandatory argument is missing: This error will 
be caused by, say, 
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\title{A Simple Document 
instead of 

\title{A Simple Document} 

• This error can also be caused by omitting the mandatory argument of 
an environment. For example, this error will occur if you do, say, 

\begin{thebibliography} 

\bibitem{kopka95} A Guide to \LaTeXe 

instead of 

\begin{thebibliography}{l} 

\bibitem{kopka95} A Guide to \LaTeXe 


B.28 Something's wrong-perhaps a missing 
\item 

You may hâve missed an \item command. The first object in a list environ¬ 
ment must either be an \item command, or another list environment. 

This error will be caused by, say, 

\begin{itemize} 

Animal 

\item Vegetable 
\item Minerai 
\end{itemize} 

instead of 

\begin{itemize} 

\item Animal 
\item Vegetable 
\item Minerai 
\end{itemize} 

This error can also be caused by a missing \bibitem in the bibliography. 
For example, the error will occur if you do, say, 

\begin{thebibliography}{l} 

A Guide to \LaTeXe 

instead of 

\begin{thebibliography}{l} 

\bibitem{kopka95} A Guide to \LaTeXe 

See also UK FAQ [18] entry: Perhaps a missing \item?. 
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B.29 There's no line here to end 

You hâve placed a line breaking command (such as \\, \newline or \linebreak) 
where it doesn't make sense to hâve one. 


B.30 Undefined control sequence 


ETgX doesn't understand the command you hâve used. 

• Check to see if you hâve misspelt the command name (remember that 
ail command names are case-sensitive.) 

You will get this error if you do, say, 

This is a simple XLatexX^document 
instead of 

This is a simple XLaTeXX^document 

• Check that you hâve remembered the space when typing V (backslash 
space). For example, this error will occur if you do, say, 

This is a \LaTeX\sample document. 

instead of 

This is a \LaTeX\,_,sample document 


X 

✓ 

X 

✓ 


• If you are using a command that is defined in a package make sure 
you hâve included the package using \usepackage. 

• Check that your command name hasn't run into the next piece of text. 
For example, you can do 


man\oe{}uvre 


or 

man\oe uvre 

or (not recommended) 

man{\oe}uvre 

but not 


man\oeuvre 


X 
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• Check if you hâve used a backslash instead of a forward slash as a 
directory divider. (Remember that when using ETgK under Windows, 
you need to use a forward slash (/) as the directory divider, as a back¬ 
slash would be interpreted as a command.) 

For example, suppose you hâve a file called shapes.pdf in a subdirec- 
tory called pictures, then you would get an error if you did 

\includegraphics{pictures\shapes} 

instead of 

\includegraphics{pictures/shapes} 


B.31 You can't use 'macro parameter character 
#' in horizontal mode 

You hâve used the spécial character # where you shouldn't hâve. Recall 
from Section 4.3 that if you want a # sign to appear you need to do \# not 
just #. 

This error message will be caused by doing, say, 

Item #1 
instead of 


Item \#1 


Appendix C 


Need More Help? 


First, try to find your query in the UK FAQ [18]. TUG [16] also has a list 
of useful resources at http://tug.org/interest.html. If you're still stuck, 
you can post your question on a (La)TeX forum, newsgroup or mailing list, 
such as those listed below. If you do post a question, remember you're 
asking people who only hâve an altruistic interest in helping. No one is 
paying them to help you. Most of the class files and packages were written 
for free by people who had a need to solve a particular problem and decided 
to make their work publicly available. So no matter how frustrated you're 
feeling, stick to being polite. If you can't work out how to use a particular 
class or package, don't start by heaping offensive, unconstructive criticism 
on it as there's a chance the author will read the message. There's no sense 
in alienating the person most qualified to answer your question. In your 
message, stick to the following guidelines: 

1. Cut to the chase. In other words, be concise about the nature of the 
problem. Don't write lots of long-winded paragraphs. 

2. Provide a minimal example 01 that illustrâtes the problem. 

Example: 

I’m trying to use the \foo command in the "bar" package, 
but I’m getting the following error message: 

! Undefined control sequence. 

1.4 \foo 

Here’s a minimal example: 

\documentclass{scrartcl} 

\usepackage{bar} 

\begin{document} 

\foo{Blah} 

\end{document} 

I’m using bar version l.Q (2012/06/30). 

Another example: 

I’m using the \foo command in the "bar" package. According 
to the documentation, this command should display its argument 


C1 see http://www.dickimaw-books.com/latex/minexample/ 
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in a bold font, but it’s coming out in italic instead. 

Anyone know why? 

Here’s a minimal example: 

\documentclass{scrartcl} 

\usepackage{bar} 

\begin{document} 

\foo{Blah} 

\end{document} 

I’m using bar version 1.1 (2012/07/30). 

There's no guarantee that you will get an answer, but if you follow the 
above guidelines, you will increase your chances. 

Resources 

• The ET^X Community (http://www.latex-community.org/). 

• T^/EI^X on StackExchange (http://tex.stackexchange.com/). 

• comp.text.tex newsgroup (use a newsreader rather than the Google 
interface if you want to avoid the spam). 

• texhax archives. 

I strongly recommend that you also hâve a look at the On-Line Catalogue [21]. 
It's also a good idea to look at the documentation that was installed with your 
T^X/ETeX distribution (see Section 1.1). If you are using MiKTeX you can ac- 
cess the on-line help via the Start Menu: 

Start—» Programs —> MiKTeX —» Help 

(Please don't send your problems to me, unless you want to hire a con¬ 
sultant. I read both the ET^X Community Forum and comp.text.tex and 
answer relevant questions if I hâve time, but it clogs up my inbox if people 
keep sending attachments that are in the order of several megabytes in size.) 
Besides, you'll reach a wide group of experts if you post to a newsgroup, 
forum or mailing list, rather than a single busy individual. 
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SUMMARY 


Commands or environments defined in the BTgX kernel are always avail- 
able. 


Symbols 

! 

1) Used in \resizebox to maintain 
aspect ratio [§6.1]; 2) Exclamation 
Symbol (end of sentence marker) 
[§2.13]. 

! ‘ 

Defined in: fflp;X Kernel. 

Upside-down exclamation mark j 
Symbol. See also \textexclamdown. 

[§4.3] 


A Visual indication of a space in the 
code. When you type up the code, 
replace ail instances of this symbol 
with a space via the space bar on 
your keyboard. [§2.0] 


% 

Defined in: ETgX Kernel. 

Comment character used to ignore 
everything up to and including the 
newline character in the source 
code. [§2.0] 

& 

Defined in: ETgX Kernel. 
Alignment tab. [§4.6] 

» 

Defined in: ETgX Kernel. 

Closing quote or apostrophe ' 
symbol in text mode or prime 
symbol ' in math mode. See also 
\textquoteright. [§4.3] 
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#{digit) 

Defined in: ETgX Kernel. 

Replacement text for argument 
(digit). [§8.0] 

$ 

Defined in: ETgX Kernel. 

Switches in and out of in-line math 
mode. [§9.1] 


Defined in: ETgX Kernel. 

Closing double quote " symbol in 
text mode or double prime " in 
math mode. See also 
\textquotedblright. [§4.3] 

( 

Defined in: ETp;X Kernel. 

Opening parenthesis in text mode 
or left round bracket délimiter in 
math mode. [§9.4] 
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) 

Defined in: ETgX Kernel. 

Closing parenthesis in text mode 
or right round bracket délimiter in 
math mode. [§9.4] 

Defined in: ETpX Kernel. 

Hyphen - in text mode or minus 
sign - in math mode. [§4.3] 

Defined in: UT^X Kernel. 

En-dash - Symbol. (Normally used 
for number ranges.) See also 
\textendash. [§4.3] 


Defined in: UI^X Kernel. 

Em-dash — symbol. (Normally 
used to indicate omissions or 
interruptions or to highlight a 
parenthetical element.) See also 
\textemdash. [§4.3] 


Defined in: ETpX Kernel. 

1) invisible délimiter [§9.4]; 2) 
period (full stop) or décimal point 
[§2.13], 

/ 

1) Forward slash délimiter (math 
mode) [§9.4]; 2) Directory divider 
[§6.0]; 3) Forward slash symbol (see 
also \slash) [§2.0]. 

< 

Defined in: ETgX Kernel (Math 
Mode). 


Less than symbol. (Use \textless 
in text mode.) [§4.3] 

<{(decl)} 

Defined in: array package. 

Used in tabular or array column 
specifiers after 1, r, c, p, m or b to 
insert ( decl ) directly after the 
entry for that column. [§4.6] 

> 

Defined in: UTpX Kernel (Math 
Mode). 

Greater than symbol. (Use 
\textgreater in text mode.) [§4.3] 

>{(decl)} 

Defined in: array package. 

Used in tabular or array column 
specifiers before 1, r, c, p, m or b to 
insert (decl) directly in front of the 
entry for that column. [§4.6] 

? 

Question mark (end of sentence 
marker). [§2.13] 

? ‘ 

Defined in: ETgX Kernel. 

Upside-down question mark £ 
symbol. See also 
\textquestiondown. [§4.3] 

@{(fexf)} 

Defined in: UI^X Kernel. 

Used in the argument of tabular or 
array like environments to specify 
text to insert between columns. 
[§4.6] 
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[ 

Defined in: Ed^X Kernel. 

1) Left square bracket délimiter in 
math mode [§9.4]; 2) Open 
délimiter of an optional argument 
[§2.8]; 3) Open square bracket in 
text mode [§4.4]. 

\& 

Defined in: ETgX Kernel. 
Ampersand & symbol [§4.3] 

\ 

Defined in: ETgX Kernel. 

Escape character (indicates a 
command). [§2.6] 

\$ 

Defined in: ETgX Kernel. 

Dollar $ symbol. [§4.3] 

\# 

Defined in: Ed^X Kernel. 

Hash # symbol. [§4.3] 

\% 

Defined in: ETgX Kernel. 

Percent % symbol [§4.3] 

V 

Defined in: ETgX Kernel (Math 
Mode). 

Négative thin space. [§9.4] 

\"{<c}} 

Defined in: ETgX Kernel. 

Umlaut over (c). Example: \"{o} 
produces ô. [§4.3] 


\’{(c)} 

Defined in: ETgX Kernel. 

Acute accent over (c). Example: 
\’{o} produces 6. [§4.3] 

\( 

Defined in: ETgX Kernel. 
Equivalent to \begin{math}. [§9.1] 

\) 

Defined in: ETgX Kernel. 
Equivalent to \end{math}. [§9.1] 

\, 

Defined in: ETgX Kernel. 

Thin space. [§9.4] 

V 

Defined in: ETgX Kernel. 

Insert discretionary hyphen. [§2.14] 

\-t(c>} 

Defined in: ETgX Kernel. 

Dot over (c). Example: \.{o} 
produces ô. [§4.3] 

V 

Defined in: Ed^X Kernel. 

Italie correction. [§4.5] 

\ : 

Defined in: ETgX Kernel (Math 
Mode). 

Medium space. [§9.4] 
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\; 

Defined in: ETgX Kernel (Math 
Mode). 

Thick space. [§9.4] 

\={{c)> 

Defined in: ETgX Kernel. 

Macron accent over (c). Example: 
\={o} produces ô. [§4.3] 

\@ 

Defined in: ETgX Kernel. 

Used when a sentence ends with a 
capital letter. This command 
should be placed after the letter 
and before the punctuation mark. 
[§2.13] 

\[ 

Defined in: ETgX Kernel 
(inconsistency corrected in 
amsmath). 

Starts an unnumbered single-line 
of displayed maths. [§9.2] 

\\[(height )] 

Defined in: Elj^X Kernel. 

[§B.10]1) Breaks a line without 
justification (starred form forbids a 
page break) [§2.8]; 2) Starts a new 
row in tabular-style environments 
[§■4.6]. 

V 

Defined in: ETgX Kernel. 

(Backslash followed by space 
character.) Horizontal spacing 
command. [§2.13] 


\] 

Defined in: ETgX Kernel 
(inconsistency corrected in 
amsmath). 

Ends an unnumbered single-line of 
displayed maths. [§9.2] 

V{(c}} 

Defined in: ETpX Kernel. 

Circumflex accent over (c). 
Example: \ A {o} produces ô. [§4.3] 

\_ 

Defined in: EljgX Kernel. 

Underscore _ Symbol (see also 
\textunderscore). [§4.3] 

\‘{<c}} 

Defined in: ETgX Kernel. 

Grave accent over (c). Example: 
\‘{o} produces 6. [§4.3] 

\{ 

Defined in: ETp;X Kernel. 

Left brace { character. In math 
mode may be used as a délimiter. 
[§4-3] 

\l 

Defined in: ETgX Kernel (Math 
Mode). 

Double vertical bar [] délimiter 
[§9.4] 

\} 

Defined in: ETp;X Kernel. 

Right brace { character. In math 
mode may be used as a délimiter. 
[§4-3] 
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\~{(c)} 

Defined in: ETgX Kernel. 

Tilde accent over (c). Example: 
\~{o} produces ô. [§4.3] 

] 

Defined in: ETgX Kernel. 

1) Right square bracket délimiter 
in math mode [§9.4]; 2) Closing 
délimiter of an optional argument 
[§2.8]; 3) Closing square bracket in 
text mode [§4.4]. 

A {( maths }} 

Defined in: ETgX Kernel (Math 
Mode). 

Displays its argument as a 
superscript. [§9.4] 

_{(maths )} 

Defined in: ETgX Kernel (Math 
Mode). 

Displays its argument as a 
subscript. [§9.4] 

t 

Defined in: ETgX Kernel. 

Open quote ' symbol. See also 
\textquoteleft. [§4.3] 

( ( 

Defined in: ETgX Kernel. 

Open double quote " symbol. See 
also \textquotedblleft. [§4.3] 

{ 

Defined in: ETgX Kernel. 

Marks the beginning of a group. 
[§2.7] 


Defined in: ETgX Kernel. 

1) Vertical rule spécifier (tabular or 
array) [§9.4]; 2) Délimiter. (Math 
mode only. Use \textbar in text 
mode.) [§9.4]. 

} 

Defined in: ETgX Kernel. 

Marks the end of a group. [§2.7] 

Defined in: Ul^X Kernel. 
Unbreakable space. [§4.5] 

A 

\AA 

Defined in: ETgX Kernel. 

Upper case A-ring Â character. 
[§4-3] 

\aa 

Defined in: Ed^X Kernel. 

Lower case a-ring â character. 

[§4-3] 

\begin{abstract} 

Defined in: Most article- or 
report-style classes, such as scrartcl 
or scrreprt. Not usually defined in 
book-style classes, such as scrbook, 
but is defined in memoir. 

Displays its contents as an abstract. 
[§5.2] 

\abstractname 

Defined in: Classes or packages 
that define an abstract environment. 

Text used in abstract heading. [§8.2] 
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\addcont ent s 1 ine { ( toc ) } { (section 
unit)} {(text)} 

Defined in: BTpX Kernel. 

Adds a sectional unit header to the 
contents list. [§5.4] 

\addto { ( command } } { (code} } 

Defined in: babel package. 

Adds (code) to the définition of 
(command). (See also \appto.) 
[§ 8 . 2 ] 

\addtocounter {(counter)} 
{(incrément)} 

Defined in: ETp;X Kernel. 

Incréments the value of a counter 
by the given amount. [§11.0] 

\addtokomaf ont { ( element 
name)}{( commands ) } 

Defined in: scrartcl, scrreprt and 
scrbook classes. 

Sets the font characteristics for the 
given KOMA-Script element. [§5.3] 

\addtolength{(regisfer}} 

{(dimension)} 

Defined in: ETp;X Kernel. 

Adds (dimension) to the value of 
the given length register. [§2.17] 

\AE 

Defined in: ETgX Kernel. 

Æ ligature. [§4.3] 

\ae 

Defined in: KTpX Kernel, 
æ ligature. [§4.3] 


\begin{align} 

Defined in: amsmath package. 

Used for numbered aligned 
équations. [§9.3] 

\begin{align*} 

Defined in: amsmath package. 

Used for unnumbered aligned 
équations. [§9.3] 

\Alph{ (counter) } 

Defined in: ETgX Kernel. 

Displays counter value as an upper 
case letter. (A, B, C, ..., Z) [§11.0] 

\alph{ (counter) } 

Defined in: ETgX Kernel. 

Displays counter value as a lower 
case letter. (a, b, c, ..., z) [§11.0] 

\alpha 

Defined in: ETp;X Kernel (Math 
Mode). 

Greek lower case alpha a. [§9.4] 
\amalg 

Defined in: ETp;X Kernel (Math 
Mode). 

Binary operator II Symbol. [§9.4] 
\and 

Defined in: ETgX Kernel. 

Used to separate authors in 
\author [§5.1] 

\appendix 

Defined in: Most classes that hâve 
the concept of document structure. 
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Indicates (but doesn't print 
anything) that the document is 
switching to the appendices. If 
chapters exist, the chapter 
numbering is reset and switched to 
a different format (usually upper 
case letters) otherwise the section 
numbering is reset and switched to 
a different format. [§5.3] 

\appendixname 

Defined in: Classes or packages 
that define chapters. 

Number prefix used in appendix 
headings. [§8.2] 

\approx 

Defined in: Ed^X Kernel (Math 
Mode). 

Relational ~ Symbol. [§9.4] 

\appto{(command)}{(code)} 

Defined in: etoolbox package. 

Adds (code) to the définition of 
(command). [§8.2] 

\arabic {(counfer)} 

Defined in: ETgX Kernel. 

Displays counter value as an 
Arabie number. (1, 2, 3, ...) [§11.0] 

\arccos 

Defined in: Ed^X Kernel (Math 
Mode). 

Typesets arccos function name. 
[§9.4] 

\arcsin 

Defined in: ETgX Kernel (Math 
Mode). 


Typesets arcsin function name. 
[§9-4] 

\arctan 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets arctan function name. 
[§9.4] 

\arg 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets arg function name. [§9.4] 

\begin{array} [(v-pos)] {( column 
specifîers )} 

Defined in: ETgX Kernel (Math 
Mode). 

Environment for lining things up 
in rows and columns. Use tabular 
for text mode. [§9.4] 

\arraycolsep 

Defined in: ETgX Kernel. 

Length register specifying half the 
gap between columns in an array 
environment. [§9.4] 

\ast 

Defined in: ETgX Kernel (Math 
Mode). 

Binary operator * symbol. [§9.4] 
\asymp 

Defined in: ETgX Kernel (Math 
Mode). 

Relational ~ symbol. [§9.4] 
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\author {(name)} 

Defined in: Most classes that hâve 
the concept of a title page. 

Spécifiés the document author (or 
authors). This command doesn't 
display any text so may be used in 
the preamble, but if it's not in the 
preamble it must be placed before 
\maketitle. [§5.1] 

B 

\b{(c}} 

Defined in: ETgX Kernel. 

Bar under (c). Example: \b{r} 
produces r. [§4.3] 

\backmatter 

Defined in: Most book-style 
classes, such as scrbook. 

Suppresses chapter and section 
numbering, but still adds unstarred 
sectional units to the table of 
contents. (See also \frontmatter 
and \mainmatter.) [§5.7] 

\backslash 

Defined in: ETgX Kernel (Math 
Mode). 

Backslash \ Symbol, which may be 
used as a délimiter. (Use 
\textbackslash for text mode.) 
[§9.4] 

\baselineskip 

Defined in: BI^X Kernel. 

A length register that stores the 
current interline spacing. This is 
recalculated whenever the font 
changes. [§10.0] 


\begin{(env-name}} [(env- 
option)] {( env-arg-1 )}...{( env-arg- 
n)} 

Defined in: BTgX Kernel. 

Starts an environment. (Must hâve 
a matching \end.) [§2.15] 

\beta 

Defined in: ETgX Kernel (Math 
Mode). 

Greek lower case beta jS. [§9.4] 
\bfseries 

Defined in: BI^X Kernel. 

Switches to the bold weight in the 
current font family. [§4.5] 

\begin{bfsériés} 

Defined in: ETgX Kernel. 

Typesets the environment contents 
in a bold font. [§2.15] 

\bibitem[(fag}] {(key)} 

Defined in: ETgX Kernel. 

Indicates the start of a new 
reference in the bibliography. May 
only be used inside the contents of 
thebibliography environment [§5.6] 

\bibname 

Defined in: Report or book style 
classes that define a bibliography 
chapter. 

Text used for bibliography chapter 
heading. (See also \refname.) [§8.2] 

\bigcap 

Defined in: ETp;X Kernel (Math 
Mode). 
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Collection intersection f] Symbol 
(may take limits). [§9.4] 

\bigcirc 

Defined in: ETgX Kernel (Math 
Mode). 

Binary operator O Symbol. [§9.4] 
\bigcup 

Defined in: ETgX Kernel (Math 
Mode). 

Collection union (J Symbol (may 
take limits). [§9.4] 

\Biggl (délimiter) 

Defined in: amsmath package 
(Math Mode). 

Left délimiter sizing. [§9.4] 

\biggl (délimiter) 

Defined in: amsmath package 
(Math Mode). 

Left délimiter sizing. [§9.4] 

\Biggr (délimiter) 

Defined in: amsmath package 
(Math Mode). 

Right délimiter sizing. [§9.4] 

\biggr (délimiter) 

Defined in: amsmath package 
(Math Mode). 

Right délimiter sizing. [§9.4] 

\Bigl (délimiter) 

Defined in: amsmath package 
(Math Mode). 

Left délimiter sizing. [§9.4] 


\bigl (délimiter) 

Defined in: amsmath package 
(Math Mode). 

Left délimiter sizing. [§9.4] 
\bigodot 

Defined in: ETgX Kernel (Math 
Mode). 

Big operator Q (may take limits). 
[§9.4] 

\bigoplus 

Defined in: EI^X Kernel (Math 
Mode). 

Big operator 0 (may take limits). 
[§9.4] 

\bigotimes 

Defined in: ETgX Kernel (Math 
Mode). 

Big operator 0 (may take limits). 
[§9-4] 

\Bigr (délimiter) 

Defined in: amsmath package 
(Math Mode). 

Right délimiter sizing. [§9.4] 

\bigr (délimiter) 

Defined in: amsmath package 
(Math Mode). 

Right délimiter sizing. [§9.4] 
\bigsqcup 

Defined in: ETp;X Kernel (Math 
Mode). 

Big operator \_\ (may take limits). 
[§9.4] 
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\bigtriangledown 

Defined in: ETp;X Kernel (Math 
Mode). 

Binary operator v symbol. [§9.4] 
\bigtriangleup 

Defined in: ETgX Kernel (Math 
Mode). 

Binary operator A symbol. [§9.4] 
\biguplus 

Defined in: BTpX Kernel (Math 
Mode). 

Big operator (+) (may take limits). 
[§9.4] 

\bigvee 

Defined in: ETgX Kernel (Math 
Mode). 

Big operator \f (may take limits). 
[§9.4] 

\bigwedge 

Defined in: ETp;X Kernel (Math 
Mode). 

Big operator /\ (may take limits). 
[§9.4] 

\begin{Bmatrix} 

Defined in: amsmath package 
(Math Mode). 

Like the array environment, but 
doesn't hâve an argument and adds 
curly brace delimiters. [§9.4] 


Like the array environment, but 
doesn't hâve an argument and adds 
square bracket delimiters. [§9.4] 

\bmod 

Defined in: ETp;X Kernel (Math 
Mode). 

Modulo operator. [§9.4] 

\boldsymbol{ (symbol)} 

Defined in: amsmath package 
(Math Mode). 

Like \mathbf but also works for 
numbers and many 
nonalphabetical symbols. (See also 
\pmb.) [§9.4] 

\bottomrule [(wd)] 

Defined in: booktabs package. 

Horizontal rule for the bottom of a 
tabular environment. [§4.6] 

\bowtie 

Defined in: ETp;X Kernel (Math 
Mode). 

Relational m symbol. [§9.4] 

\bullet 

Defined in: ETp;X Kernel (Math 
Mode). 

Binary operator • symbol. [§9.4] 

C 

\c{(c}} 

Defined in: ETgX Kernel. 

Cedilla under (c). Example: \c{o} 
produces 9 . [§4.3] 
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\begin{bmatrix} 

Defined in: amsmath package 
(Math Mode). 


\cap 

Defined in: ETgX Kernel (Math 
Mode). 
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Binary operator fl Symbol. [§9.4] 

\caption[(sfrorf 
caption)] {(caption text }} 

Defined in: ETgX Kernel. 

Inserts the caption for a float such 
as a figure or table. This 
command has a moving 
argument. [§7.0] 

\captionsetup [(float 
type)] {(options)} 

Defined in: caption package. 

Used to set up the options affecting 
float captions. [§7.4] 

\begin{cases} 

Defined in: amsmath package 
(Math Mode). 

Like the array environment, but 
adds a left brace start délimiter and 
an invisible end délimiter. [§9.4] 

\cdot 

Defined in: BTgX Kernel (Math 
Mode). 

Centred dot • Symbol. [§9.4] 

\cdots 

Defined in: ETgX Kernel (Math 
Mode). 

Centred ellipses • • • symbol. [§9.4] 
\centering 

Defined in: ETgX Kernel. 

Switches the paragraph alignment 
to centred. [§2.12] 


\cfrac [(pos)] {( numerator )} 

{( denominator )} 

Defined in: amsmath (Math Mode). 
Displays a continued fraction. [§9.4] 

\chapter {(short title)] {(title)} 

Defined in: Book-style classes 
(such as scrbook or scrreprt) that 
hâve the concept of chapters. 

Inserts a chapter heading. This 
command has a moving 
argument. [§5.3] 

\chaptername 

Defined in: Classes or packages 
that define chapters. 

Number prefix used in chapter 
headings. [§8.2] 

\chi 

Defined in: ETp;X Kernel (Math 
Mode). 

Greek lower case chi x■ [§9.4] 

\circ 

Defined in: ETgX Kernel (Math 
Mode). 

Circle o symbol. [§9.4] 

\cite [(text)] {(key list)} 

Defined in: ETgX Kernel. 

Inserts the citation markers of 
each reference identified in the 
key list. A second run is required 
to ensure the reference is correct. 
[§5.6] 

\color [(mode!)] {( specs )} 

Defined in: color and xcolor 

packages. 
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A déclaration that switches the 
current foreground colour to the 
given spécification. [§8.0] 

\cong 

Defined in: Kernel (Math 

Mode). 

Relational = Symbol. [§9.4] 
\contentsname 

Defined in: Classes or packages 
that define a table of contents. 

Text used for table of contents 
heading. [§8.2] 

\coprod 

Defined in: ETgX Kernel (Math 
Mode). 

Co-product JJ symbol (may take 
limits). [§9.4] 

\copyright 

Defined in: ETgX Kernel. 
Copyright © symbol. [§4.3] 

\cos 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets cos function name. [§9.4] 
\cosh 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets cosh function name. [§9.4] 
\cot 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets cot function name. [§9.4] 


\coth 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets coth function name. [§9.4] 
\csc 

Defined in: EŒ^X Kernel (Math 
Mode). 

Typesets esc function name. [§9.4] 
\cup 

Defined in: ETgX Kernel (Math 
Mode). 

Operator U symbol. [§9.4] 
\currenttime 

Defined in: datetime package. 

Inserts into the output file the time 
when the ETgX application created 
it from the source code. [§4.2] 

D 

\d{(c)} 

Defined in: ETpX Kernel. 

Dot under (c). Example: \d{o} 
produces o. [§4.3] 

\dag 

Defined in: ETgX Kernel. 

Dagger "f symbol. [§4.3] 

\dagger 

Defined in: ETpX Kernel (Math 
Mode). 

Binary operator f symbol. [§9.4] 
\dashv 

Defined in: ETgX Kernel (Math 
Mode). 
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Relational H Symbol. [§9.4] 
\date{(fexf}} 

Defined in: Most classes that hâve 
the concept of a title page. 

Spécifiés the document date. This 
command doesn't display any text 
so may be used in the preamble, 
but if it's not in the preamble it 
must be placed before \maketitle. 
If omitted, most classes assume the 
current date (as provided by 
\today). [§5.1] 

\ddag 

Defined in: ETgX Kernel. 
Double-dagger J symbol. [§4.3] 

\ddagger 

Defined in: ETp;X Kernel (Math 
Mode). 

Binary operator $ symbol. [§9.4] 

\ddmmyyyydat e 

Defined in: datetime package. 

Changes the format of \today so 
that it displays the date in the form 
09/02/2014 (day/month/year in 
digits). [§4.2] 

\ddots 

Defined in: ETp;X Kernel (Math 
Mode). 

Diagonal ellipses symbol. [§9.4] 

\DeclareCaptionLabelFormat 

{(name)}{(code)} 

Defined in: caption. 

Used to defined your own caption 
label formats. [§7.4] 


\DeclareGraphicsExtensions 

{( ext-list )} 

Defined in: graphicx package. 

Specify the file extensions to look 
for if no extension is used in 
\includegraphics [§6.0] 

\DeclareMathOperator {(cmd)} 

{ ( op erator-name ) } 

Defined in: amsmath package 
(Preamble Only). 

Defines a new maths operator. The 
starred version allows limits. [§9.4] 

\deg 

Defined in: ETp;X Kernel (Math 
Mode). 

Typesets deg function name. [§9.4] 
\Delta 

Defined in: ETgX Kernel (Math 
Mode). 

Greek upper case delta A. [§9.4] 
\delta 

Defined in: ET^X Kernel (Math 
Mode). 

Greek lower case delta ô. [§9.4] 

\begin{description} 

Defined in: Most class files. 
Labelled list. [§4.4] 

\det 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets det function name (may 
hâve limits via _ or A ). [§9.4] 
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\diamond 

Defined in: ETgX Kernel (Math 
Mode). 

Binary operator o Symbol. [§9.4] 
\dim 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets dim function name. [§9.4] 
\ding {(n)} 

Defined in: pifont package. 

Inserts PostScript ZapfDingbats 
character with code (n), which 
must be an integer. [§8.2] 

\begin{dinglist}{(number)} 

Defined in: pifont package. 

A list where the item marker is 
given by character ( number } in 
the Zapf Dingbats font. [§8.2] 

\displaybreak[(n}] 

Defined in: amsmath package. 

Allows a page break in multi-lined 
maths environments, such as aliqn. 
[§9.3] 

\div 

Defined in: ETgK Kernel (Math 
Mode). 

Division operator Symbol. [§9.4] 

\begin{document} 

Defined in: ETgX Kernel. 

The body of the document. [§4.0] 


\documentclass [(option-list)] 

{( class-name )} 

Defined in: ETp;X Kernel. 

Loads the document class file, 
which sets up the type of 
document you wish to write. [§4.0] 

\doteq 

Defined in: ETgX Kernel (Math 
Mode). 

Relational = Symbol. [§9.4] 

\dotsb 

Defined in: amsmath (Math Mode). 

Ellipses • • • for dots with binary 
operators/relations. [§9.4] 

\dotsc 

Defined in: amsmath (Math Mode). 

Ellipses ... for dots with commas. 
[§9.4] 

\dotsi 

Defined in: amsmath (Math Mode). 

Ellipses • • • for dots with intégrais. 
[§9.4] 

\dotsm 

Defined in: amsmath (Math Mode). 

Ellipses • • • for dots with 
multiplications. [§9.4] 

\dotso 

Defined in: amsmath (Math Mode). 
Ellipses ... for general dots. [§9.4] 

\doublebox{(fexf}} 

Defined in: fancybox package. 
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Puts a double-lined frame around 
its contents, prohibiting a line 
break in the contents. [§4.7] 

\Downarrow 

Defined in: Kernel (Math 

Mode). 

Double-lined down arrow JJ,- (May 
be used as a délimiter.) [§9.-4] 

\downarrow 

Defined in: ETgK Kernel (Math 
Mode). 

Down arrow J,. (May be used as a 
délimiter.) [§9.4] 

E 

\em 

Defined in: ETgX Kernel. 

Toggles the upright and 
italic/slanted form of the current 
font family. [§4.5] 

\begin{em} 

Defined in: ETgX Kernel. 

Typesets the environment contents 
in an emphasized font. (Switches to 
italic/slanted if the surrounding 
font is upright, or switches to 
upright if the surrounding font is 
italic/slanted.) [§4.5] 

\emph{(fexf}} 

Defined in: ETgX Kernel. 

Toggles the upright and 
italic/slanted rendering of ( text ). 
[§4-5] 

\end {(env-name)} 

Defined in: ETgX Kernel. 


Ends an environment. (Must hâve 
a matching \begin.) [§2.15] 

\enspace 

Defined in: ETgX Kernel. 

Horizontal spacing command (half 
as wide as \quad). [§2.13] 

\begin{enumerate} 

Defined in: ETgX Kernel. 

Ordered list. [§4.4] 

\epsilon 

Defined in: ETgX Kernel (Math 
Mode). 

Greek lower case epsilon e. [§9.4] 

\eqref{(label)} 

Defined in: amsmath package. 

Short eut for (\ref{(label)}) for 
referencing équations. [§9.2] 

\begin{équation} 

Defined in: ETgX Kernel. 

Displays its contents as a 
single-lined numbered équation. 
[§9-2] 

\equiv 

Defined in: ETgX Kernel (Math 
Mode). 

Relational s symbol. [§9.4] 

\eta 

Defined in: ETgX Kernel (Math 
Mode). 

Greek lower case eta 17 . [§9.4] 
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\exp 

Defined in: Ed^gX Kernel (Math 
Mode). 

Typesets exp function name. [§9.4] 

F 

\familydefault 

Defined in: Kernel. 

Spécifiés the default font family. 
Defaults to \rmdefault but may be 
redefined by certain classes. [§8.2] 

\fbox{(text)} 

Defined in: ETgX Kernel. 

Puts a frame around its contents, 
prohibiting a line break in the 
contents. [§4.7] 

\begin{figure} [( placement )] 

Defined in: Most classes that 
define sectioning commands. 

Floats the contents to the nearest 
location according to the preferred 
placement options, if possible. 
Within the environment, \caption 
may be used one or more times, as 
required. The caption will usually 
include the prefix given by 
\figurename. [§7.1] 

\figurename 

Defined in: Classes or packages 
that define figures. 

Number prefix used in figure 
captions. [§8.2] 

\ f nsymbo 1 { ( court ter ) } 

Defined in: ETgX Kernel. 

Displays counter value as footnote 
symbol. (*ft§K H** fl fl) [§11.0] 


\footnote [(number)] {(text)} 
Defined in: ETgX Kernel. 

Inserts a footnote. [§4.1] 

\footnotesize 

Defined in: Most document 
classes. 

Switches to footnote sized text. 
[§4-5] 

\forall 

Defined in: ETgX Kernel (Math 
Mode). 

"For ail" V symbol. [§9.4] 

\foreignlanguage{(langruage 
name)} {(text}} 

Defined in: babel package. 

Typesets the given text using any 
predefined names or date formats 
supplied by the given language. 
[§5.8] 

\frac{ (numerator)} 

{( denominator )} 

Defined in: Ed^X Kernel (Math 
Mode). 

Displays a fraction. [§9.4] 

\framebox {(width)} [( align )] 
{(text)} 

Defined in: ETgX Kernel. 

Puts a frame around its contents, 
prohibiting a line break in the 
contents. [§4.7] 

\frenchspacing 
Defined in: ETgX Kernel. 

Switch to French spacing. [§2.13] 
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\frontmatter 

Defined in: Most book-style 
classes, such as scrbook. 

Switches to lower case Roman 
numéral page numbering. Also 
suppresses chapter and section 
numbering, but still adds unstarred 
sectional units to the table of 
contents. (See also \mainmatter 
and \backmatter.) [§5.7] 

\frown 

Defined in: ETp;X Kernel (Math 
Mode). 

Relational ^ symbol. [§9.4] 

G 

\Gamma 

Defined in: ETgX Kernel (Math 
Mode). 

Greek upper case gamma T. [§9.4] 
\gamma 

Defined in: ETp;X Kernel (Math 
Mode). 

Greek lower case gamma 7 . [§9.4] 
\gcd 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets gcd function name (may 
hâve limits via _ or A ). [§9.4] 

\ge 

Defined in: Ed^gX Kernel (Math 
Mode). 

Relational > symbol. [§9.4] 


\geq 

Defined in: ETgX Kernel (Math 
Mode). 

Relational > symbol. [§9.4] 

\gets 

Defined in: ETgX Kernel (Math 
Mode). 

Left arrow . [§9.4] 

\gg 

Defined in: ETgX Kernel (Math 
Mode). 

Relational » symbol. [§9.4] 

H 

\H{(c}} 

Defined in: Ed^gX Kernel. 

Double acute diacritic over (c). 
Example: \H{o} produces ô. [§4.3] 

\heavyrulewidth 

Defined in: booktabs package. 

Length register specifying the 
thickness of \toprule and 
\bottomrule. [§4.6] 

\hom 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets hom function name. [§9.4] 

\hookleftarrow 

Defined in: ETgX Kernel (Math 
Mode). 

Hooked left arrow >. [§9.4] 

\hookrightarrow 

Defined in: ETgX Kernel (Math 
Mode). 
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Hooked right arrow <—». [§9.4] 

\hspac e{(length)} 

Defined in: ETp;X Kernel. 

Inserts a horizontal gap of the 
given width. [§4.6] 

\Huge 

Defined in: Most document 
classes. 

Switches to extra-huge sized text. 
[§4.5] 

\huge 

Defined in: Most document 
classes. 

Switches to huge sized text. [§4.5] 

\hyphenat i on { ( word ) } 

Defined in: ETgK Kernel. 

Spécifiés hyphenation points. 

[§2.14] 

I 

\i 

Defined in: ETgX Kernel. 

Dotless i character: 1 . [§4.3] 

\iflanguage{ (language 
name)}{(true text)} {(/ aise text)} 

Defined in: babel package. 

Tests the current language. [§5.8] 

\ignorespaces 

Defined in: ETgX Kernel. 

Used in begin environment code to 
suppress any spaces occurring at 
the start of the environment (see 
also \ignorespacesafterend). 
[§ 10 . 0 ] 


\ignorespacesafterend 

Defined in: ETgK Kernel. 

Used in end environment code to 
suppress any spaces following the 
end of the environment. [§10.0] 

\in 

Defined in: ETgX Kernel (Math 
Mode). 

Relational e Symbol. [§9.4] 

\includegraphics [(key 
vais)} {( filename )} 

Defined in: graphicx package. 

Inserts a graphies file into the 
document. [§6.0] 

\index{(fexf}} 

Defined in: ETgX Kernel. 

Adds indexing information to an 
external index file. The command 
\makeindex must be used in the 
preamble to enable this command. 
The external index file must be 
post-processed with an indexing 
application, such as makeindex. 
[§ 8 . 0 ] 

\indexname 

Defined in: Classes or packages 
that define an index section. 

Text used for index heading. [§8.2] 
\inf 

Defined in: ETp;X Kernel (Math 
Mode). 

Typesets inf function name (may 
hâve limits via _ or A ). [§9.4] 
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\infty 

Defined in: ETgX Kernel (Math 
Mode). 

Infinity oo symbol. [§9.4] 

\injlim 

Defined in: amsmath (Math Mode). 

Typesets inj lim function name 
(may hâve limits via _ or A ). [§9.4] 

\int 

Defined in: ETgX Kernel (Math 
Mode). 

Intégral f symbol (may take 
limits). [§9.4] 

\intertext{(fexf)} 

Defined in: amsmath package 
(Math Mode). 

Used for a short interjection in the 
middle of a multi-line displayed 
maths, such as in an align 
environment. May only appear 
right after \\. [§9.3] 

\iota 

Defined in: Ed^X Kernel (Math 
Mode). 

Greek lower case iota i. [§9.4] 

\item [(marker)] 

Defined in: ETgX Kernel. 

Spécifiés the start of an item in a 
list. (Only allowed inside one of the 
list making environments.) [§4.4] 

\begin{itemize} 

Defined in: ETgX Kernel. 
Unordered list. [§4.4] 


\begin{itshape} 

Defined in: ETgX Kernel. 

Typesets the environment contents 
in an italic font. [§4.5] 

\itshape 

Defined in: ETgX Kernel. 

Switches to the italic form of the 
current font family, if it exists. 

[§4-5] 

J 

\j 

Defined in: ETgX Kernel. 

Dotless j character: j. [§4.3] 

K 

\kappa 

Defined in: EdjgX Kernel (Math 
Mode). 

Greek lower case kappa k. [§9.4] 
\ker 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets ker function name. [§9.4] 

L 

\L 

Defined in: ETgX Kernel. 

Upper case L-bar t character. 

[§4-3] 

\1 

Defined in: ETgX Kernel. 

Lower case l-bar 1 character. [§4.3] 

\label {(string)} 

Defined in: BTpX Kernel. 
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Assigns a unique textual label 
linked to the most recently 
incremented cross-referencing 
counter in the current scope (see 
also \ref). [§5.5] 

\label format {(ctr)} {(defn)} 

Defined in: fncylab package. 

Defines how the label for the 
counter (ctr) should be formatted. 
The définition (defn) should use #1 
to indicate the label value. [§7.4] 

\labelitemi 

Defined in: Classes that define the 
itemize environment. 

The default label for the first level 
itemize. [§8.2] 

\labelitemii 

Defined in: Classes that define the 
itemize environment. 

The default label for the second 
level itemize. [§8.2] 

\labelitemiii 

Defined in: Classes that define the 
itemize environment. 

The default label for the third level 
itemize. [§8.2] 

\labelitemiv 

Defined in: Classes that define the 
itemize environment. 

The default label for the fourth 
level itemize. [§8.2] 

\Lambda 

Defined in: ETgX Kernel (Math 
Mode). 


Greek upper case lambda A. [§9.4] 
\lambda 

Defined in: ETgX Kernel (Math 
Mode). 

Greek lower case lambda X. [§9.4] 
\langle 

Defined in: ETp;X Kernel (Math 
Mode). 

Left-angled ( délimiter. [§9.4] 
\LARGE 

Defined in: Most document 
classes. 

Switches to extra-extra-large sized 
text. [§4.5] 

\Large 

Defined in: Most document 
classes. 

Switches to extra-large sized text. 
[§4-5] 

\large 

Defined in: Most document 
classes. 

Switches to large sized text. [§4.5] 
\LaTeX 

Defined in: ETgX Kernel. 

Typesets the ETgX logo. [§2.6] 

\LaTeXe 

Defined in: EI^X Kernel. 

Typesets the ETj;X 2 e logo. [§5.6] 
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\lceil 

Defined in: ETgX Kernel (Math 
Mode). 

Left ceil [ délimiter. [§9.4] 
\ldots 

Defined in: ETgX Kernel. 
Ellipses ... symbol. [§4.3] 


\le 

Defined in: ETgX Kernel (Math 
Mode). 

Relational < symbol. [§9.4] 


\left (délimiter) 

Defined in: ETgX Kernel (Math 
Mode). 

Indicates a left stretchable 
délimiter. Must hâve a matching 
\right. [§9.4] 


\Leftarrow 

Defined in: ETgX Kernel (Math 
Mode). 

Double-lined left arrow <=. [§9.4] 


\leftarrow 

Defined in: ETp;X Kernel (Math 
Mode). 

Left arrow . [§9.4] 


\leftharpoondown 

Defined in: ETgX Kernel (Math 
Mode). 

Left down harpoon [§9.4] 


\leftharpoonup 

Defined in: ETgX Kernel (Math 
Mode). 


Left up harpoon [§9.4] 


\Leftrightarrow 

Defined in: KTpX Kernel (Math 
Mode). 

Double-ended double-lined 
horizontal arrow o. [§9.4] 


\leftrightarrow 

Defined in: ETgX Kernel (Math 
Mode). 

Double-ended horizontal arrow <-». 
[§9.4] 


\leq 

Defined in: ETgX Kernel (Math 
Mode). 

Relational < symbol. [§9.4] 
\lfloor 

Defined in: EI^X Kernel (Math 
Mode). 

Left floor [ délimiter. [§9.4] 

\ig 

Defined in: ETp;X Kernel (Math 
Mode). 

Typesets lg function name. [§9.4] 
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\lightrulewidth 

Defined in: booktabs package. 

Length register specifying the 
thickness of \midrule. [§4.6] 


\lim 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets lim function name (may 
hâve limits via _ or A ). [§9.4] 
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\liminf 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets lim inf function name 
(may hâve limits via _ or A ). [§9.4] 

\limsup 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets lim sup function name 
(may hâve limits via _ or A ). [§9.4] 

\linebreak[(n)] 

Defined in: ETgX Kernel. 

Requests a line break, ensuring the 
paragraph remains justified. This 
may cause excess white space in 
the paragraph. [§B.29] 

\linewidth 

Defined in: ETgX Kernel. 

A length containing the desired 
current line width. This is usually 
the width of the typeblock, but 
inside a minipage or \parbox it will 
be the width the box. Note that the 
actual contents of the line may fall 
short of the line width (underfull 
hbox) or extend beyond it (overfull 
hbox). [§4.7] 

\listfigurename 

Defined in: Classes or packages 
that define a list of figures. 

Text used for list of figures 
heading. [§8.2] 

\listoffigures 

Defined in: Most classes that hâve 
the concept of document structure. 


Inserts the list of figures. A second 
(possibly third) run is required to 
ensure the page numbering is 
correct. [§7.1] 

\listoftables 

Defined in: Most classes that hâve 
the concept of document structure. 

Inserts the list of tables. A second 
(possibly third) run is required to 
ensure the page numbering is 
correct. [§7.2] 

\listtablename 

Defined in: Classes or packages 
that define a list of tables. 

Text used for list of tables heading. 

[§ 8 . 2 ] 

\11 

Defined in: ETp;X Kernel (Math 
Mode). 

Relational « symbol. [§9.4] 

\ln 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets ln function name. [§9.4] 
\log 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets log function name. [§9.4] 

\Longleftarrow 

Defined in: ETgX Kernel (Math 
Mode). 

Long double-lined left arrow <^=. 
[§9.4] 


Symbols 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

O 

P 

Q 

R 

S 

T 

U 

V 

w 

X 

Y 
Z 





Summary 


224 


\longleftarrow 

Defined in: ETgX Kernel (Math 
Mode). 

Long left arrow <—. [§9.4] 

\Longleftrightarrow 

Defined in: ETgX Kernel (Math 
Mode). 

Long double-lined double-ended 
horizontal arrow #=#•. [§9.4] 

\longleftrightarrow 

Defined in: ETp;X Kernel (Math 
Mode). 

Long double-ended horizontal 
arrow <—». [§9.4] 

\longmapsto 

Defined in: ETp;X Kernel (Math 
Mode). 

Long mapping arrow i—». [§9.4] 

\Longrightarrow 

Defined in: ETgX Kernel (Math 
Mode). 

Long double-lined right arrow =>. 

[§9.4] 

\longrightarrow 

Defined in: ETgX Kernel (Math 
Mode). 

Long right arrow —». [§9.4] 

\lVert 

Defined in: amsmath (Math Mode). 

Left double vertical bar [] délimiter. 
[§9-4] 


\lvert 

Defined in: amsmath (Math Mode). 
Left vertical bar | délimiter. [§9.4] 

M 

\mainmatter 

Defined in: Most book-style 
classes, such as scrbook. 

Switches to Arabie page 
numbering and enables chapter 
and section numbering. (See also 
\frontmatter and \backmatter.) 

[§5.7] 

\makeindex 

Defined in: ETgX Kernel 
(Preamble Only). 

Enables \index. [§8.0] 

\maketitle 

Defined in: Most classes that hâve 
the concept of a title page. 

Generates the title page (or title 
block). This command is usually 
placed at the beginning of the 
document environment. [§5.1] 

\mapsto 

Defined in: ETgX Kernel (Math 
Mode). 

Mapping arrow i—». [§9.4] 

\markboth {(left head}}{(right 
head }} 

Defined in: ETgX Kernel. 

Spécifiés information for the left 
and right page headers. Not ail 
page styles use this information, in 
which case the arguments are 
ignored. [§5.7] 
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\markright {(right head }} 

Defined in: ETgX Kernel. 

Spécifiés information for the right 
(odd) page header. Not ail page 
styles use this information, in 
which case the argument is 
ignored. [§5.7] 

\begin{math} 

Defined in: ETgX Kernel. 

Sets its contents in in-line math 
mode. [§9.1] 

\mathbb {(maths)} 

Defined in: amsfonts package 
(Math Mode). 

Typesets its argument in the 
blackboard bold font. Example: 
\(\mathbb{R}\) produces M. [§9.4] 

\mathb f { ( maths) } 

Defined in: ETgX Kernel (Math 
Mode). 

Renders (maths) in the predefined 
maths bold font. (Doesn't work 
with numbers and nonalphabetical 
symbols.) See also \boldsymbol. 
[§9.4] 


Typesets its argument in Euler 
Fraktur letters. Example: 
\(\mathfrak{U}\) produces it. 
[§9.4] 

\mathit {(maths)} 

Defined in: EI^X Kernel (Math 
Mode). 

Renders (maths) in the predefined 
maths italic font. [§9.4] 

\mathrm{ ( maths ) } 

Defined in: ETgX Kernel (Math 
Mode). 

Renders (maths) in the predefined 
maths serif font. [§9.4] 

\maths f {(maths ) } 

Defined in: EI^X Kernel (Math 
Mode). 

Renders (maths) in the predefined 
maths sans-serif font. [§9.4] 

\matht t { ( maths ) } 

Defined in: ËTgX Kernel (Math 
Mode). 

Renders (maths) in the predefined 
maths typewriter font. [§9.4] 
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\mathc al { (maths)} 

Defined in: ETp;X Kernel (Math 
Mode). 

Typesets its argument in the maths 
calligraphie font. Example: 
\(\mathcal{S}\) produces S. 

[§9-4] 

\mathfrak{(mafhs}} 

Defined in: amsfonts package 
(Math Mode). 


\begin{matrix} 

Defined in: amsmath package 
(Math Mode). 

Like the array environment, but 
doesn't hâve an argument. [§9.4] 

\max 

Defined in: ETp;X Kernel (Math 
Mode). 

Typesets max function name (may 
hâve limits via _ or A ). [§9.4] 
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\mbo x{(text)} 

Defined in: ETgX Kernel. 

Ensures that the given text doesn't 
contain a line break. [§4.7] 

\mdseries 

Defined in: ETgX Kernel. 

Switches to the medium weight in 
the current font family. [§4.5] 

\medspace 

Defined in: amsmath package. 
Medium space. [§9.4] 

\mid 

Defined in: ETp;X Kernel (Math 
Mode). 

Relational | Symbol. [§9.4] 

\midrule[(wd)] 

Defined in: booktabs package. 

Horizontal rule to go below 
headings row of a tabular 
environment. [§4.6] 

\min 

Defined in: EI^X Kernel (Math 
Mode). 

Typesets min function name (may 
hâve limits via _ or A ). [§9.4] 

\begin{minipage} [(pos)] 
[(heighf)] {( width )} 

Defined in: ETgX Kernel. 

Makes a box with line-wrapped 
contents. (See also \parbox.) [§4.7] 


\minis ec{(heading)} 

Defined in: scrartcl, scrreprt and 
scrbook classes. 

An unnumbered heading not 
associated with any structuring 
level. [§5.3] 

\mod {(maths)} 

Defined in: amsmath (Math Mode). 

Modulo operator without 
parenthèses. [§9.4] 

\models 

Defined in: ETgX Kernel (Math 
Mode). 

Relational |= symbol. [§9.4] 

\mp 

Defined in: ETgX Kernel (Math 
Mode). 

Minus or plus operator + symbol. 

[§9.4] 

\mu 

Defined in: ETp;X Kernel (Math 
Mode). 

Greek lower case mu p. [§9.4] 

\multicolumn{(cols 

spanned ) } { (col spécifier) } { ( text) } 

Defined in: ETp;X Kernel. 

Spans multiple columns in a 
tabular-style environment. [§4.6] 

N 

\nearrow 

Defined in: RI^X Kernel (Math 
Mode). 

North-East arrow /A [§9.4] 
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\negmedspace 

Defined in: amsmath package. 
Négative medium space. [§9.4] 

\negthickspace 

Defined in: amsmath package. 

Négative thick space. [§9.4] 

\negthinspace 
Defined in: ETgX Kernel. 

Négative thin space. [§9.4] 

\neq 

Defined in: ETgX Kernel (Math 
Mode). 

Relational f Symbol. [§9.4] 

\newcommand {(cmd)} [(n-args)] 

[( default )] {(text)} 

Defined in: ETgX Kernel. 

Defines a new command. [§8.0] 

\newcounter {(counfer}} [(oufer 
counfer}] 

Defined in: ETgX Kernel. 

Defines a new counter. [§11.0] 

\newenvironment {(env-name)} [(n- 
args )] [(de/auh)] {( begin-code )} 
{(end-code)} 

Defined in: ETgX Kernel. 

Defines a new environment. [§10.0] 

\newline 

Defined in: ETgX Kernel. 

Forces a line break. [§B.29] 


\ni 

Defined in: ETgX Kernel (Math 
Mode). 

Relational 9 Symbol. [§9.4] 
\noindent 

Defined in: ETgX Kernel. 

Suppress the indentation that 
would usually occur at the start of 
the next paragraph. [§10.0] 

\nonfrenchspacing 
Defined in: ETpX Kernel. 

Switch to English spacing. [§2.13] 

\normalfont 

Defined in: ETgX Kernel. 

Switches to the default font style. 
[§4-5] 

\normalsize 

Defined in: ETgX Kernel. 

Switches to normal sized text. [§4.5] 

\not (symbol command ) 

Defined in: ETpX Kernel (Math 
Mode). 

Negates the following symbol. 
Example: \not\subset produces <jt. 
[§9.4] 

\notag 

Defined in: amsmath package. 

Suppresses équation numbering 
for the current row in 
environments such as align. [§9.3] 
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\notin 

Defined in: ETgX Kernel (Math 
Mode). 

Relational é Symbol. [§9.4] 

\nu 

Defined in: ETgX Kernel (Math 
Mode). 

Greek lower case nu v. [§9.4] 
\nwarrow 

Defined in: fflp;X Kernel (Math 
Mode). 

North-West arrow \. [§9.4] 

O 

\0 

Defined in: ETgX Kernel. 

Upper case slashed-O 0 character. 
[§4-3] 

\o 

Defined in: fflp;X Kernel. 

Lower case slashed-o 0 character. 
[§4-3] 

\odot 

Defined in: ETgX Kernel (Math 
Mode). 

Operator 0 symbol. [§9.4] 

\0E 

Defined in: ETgX Kernel. 

Œ ligature. [§4.3] 

\oe 

Defined in: KTpX Kernel, 
œ ligature. [§4.3] 


\oint 

Defined in: ETgX Kernel (Math 
Mode). 

Closed path intégral j symbol 
(may take limits). [§9.4] 


\Omega 

Defined in: BTpX Kernel (Math 
Mode). 

Greek upper case oméga Q. [§9.4] 


\omega 

Defined in: EŒ^X Kernel (Math 
Mode). 

Greek lower case oméga u. [§9.4] 


\ominus 

Defined in: ETgX Kernel (Math 
Mode). 

Operator © symbol. [§9.4] 


\oplus 

Defined in: KTpX Kernel (Math 
Mode). 

Operator 0 symbol. [§9.4] 
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\oslash 

Defined in: ETgX Kernel (Math 
Mode). 

Operator 0 symbol. [§9.4] 


\begin{otherlanguage} {(language 
name )} 

Defined in: babel package. 

Within the environment contents, 
predefined textual éléments, such 
as the date given by \today or 
préfixés like "Chapter", are set to 
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those supplied by the given 
language. [§5.8] 

\otimes 

Defined in: ETgX Kernel (Math 
Mode). 

Operator ® symbol. [§9.4] 

\Ovalbox{(fexf}} 

Defined in: fancybox package. 

Puts a thick-lined oval frame 
around its contents, prohibiting a 
line break in the contents. [§4.7] 

\ovalbox{(fexf}} 

Defined in: fancybox package. 

Puts a thin-lined oval frame 
around its contents, prohibiting a 
line break in the contents. [§4.7] 

\overleftarrow {(maths)} 

Defined in: ETgX Kernel (Math 
Mode). 

Puts an extendible left arrow over 
(maths) [§9.4] 

\overleftrightarrow {(maths)} 

Defined in: amsmath package 
(Math Mode). 

Puts an extendible left-right arrow 
over (maths) [§9.4] 

\overrightarrow{(mafhs)} 

Defined in: ET^X Kernel (Math 
Mode). 

Puts an extendible right arrow 
over (maths) [§9.4] 

P 

\P 

Defined in: ETgX Kernel. 


Paragraph symbol. [§4.3] 

\pagenumbering{ (style)} 

Defined in: ET E X Kernel. 

Sets the style of the page numbers. 
[§5.7] 

\pageref{(sfring}} 

Defined in: ET E X Kernel. 

Similar to \ref but inserts the page 
number where the given label was 
defined. A second (possibly third) 
run of ET E X is required to ensure 
the cross-references are up-to-date. 
[§5.5] 

\pagestyl e{(style)} 

Defined in: ET E X Kernel. 

Sets the style of the headers and 
footers. [§5.7] 

\par 

Defined in: ET E X Kernel. 

Insert a paragraph break. [§4.0] 

\paragraph[(shorf title)] {(title)} 

Defined in: Most classes that hâve 
the concept of document structure. 

Inserts a subsubsubsection header. 
Most classes default to an 
unnumbered running header for 
this sectional unit. This command 
has a moving argument. [§5.3] 

\parallel 

Defined in: ET E X Kernel (Math 
Mode). 

Relational [] symbol. [§9.4] 


Symbols 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

O 

P 

Q 

R 

S 

T 

U 

V 

w 

X 

Y 
Z 



Summary 


230 


\parbo x[(pos}] [(heigrht)] 

{(width)} {(text)} 

Defined in: ETgX Kernel. 

Makes a box with line-wrapped 
contents. (More restrictive than 
minipage.) [§4.7] 

\parindent 

Defined in: ETgX Kernel. 

A length register that stores the 
indentation at the start of 
paragraphs. [§2.17] 

\parskip 

Defined in: ETp;X Kernel. 

A length register that stores the 
spacing between paragraphs. (If 
you're using one of the 
KOMA-Script classes, use the 
parskip option to set it to full or 
half line height.) [§2.17] 

\part [(short title)] {(title)} 

Defined in: Most classes that hâve 
the concept of document structure. 

Inserts a part sectional unit. This 
command has a moving 
argument. [§5.3] 

\partial 

Defined in: ETgX Kernel (Math 
Mode). 

Partial d Symbol. [§9.4] 

\partname 

Defined in: Classes or packages 
that define parts with a number 
prefix. 

Number prefix used in part 
headings. [§8.2] 


\perp 

Defined in: ETp;X Kernel (Math 
Mode). 

Relational 1 Symbol. [§9.4] 

\Phi 

Defined in: ETgX Kernel (Math 
Mode). 

Greek upper case phi <î>. [§9.4] 

\phi 

Defined in: KTpX Kernel (Math 
Mode). 

Greek lower case phi <j>. [§9.4] 

\Pi 

Defined in: ETgX Kernel (Math 
Mode). 

Greek upper case pi n. [§9.4] 

\pi 

Defined in: ETp;X Kernel (Math 
Mode). 

Greek lower case pi tt. [§9.4] 

\pm 

Defined in: El^gX Kernel (Math 
Mode). 

Operator ± symbol. [§9.4] 

\begin{pmatrix} 

Defined in: amsmath package 
(Math Mode). 

Like the array environment, but 
doesn't hâve an argument and adds 
round bracket delimiters. [§9.4] 
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\pmb {(symbol)} 

Defined in: amsmath package 
(Math Mode). 

"Poor man's bold." Overlays 
multiple copies of the Symbol to 
produce a bold effect for symbols 
that don't work with \boldsymbol. 
[§9.4] 

\pmod{ (maths)} 

Defined in: ETgX Kernel (Math 
Mode). 

Modulo operator with parenthèses. 
[§9.4] 

\pod{(mafhs}} 

Defined in: amsmath (Math Mode). 

Modulo operator with parenthèses 
but no "mod". [§9.4] 

\pounds 

Defined in: ETgX Kernel. 

Pound £ symbol. [§4.3] 

\Pr 

Defined in: RI^X Kernel (Math 
Mode). 

Typesets Pr function name (may 
hâve limits via _ or A ). [§9.4] 

\prec 

Defined in: ETgX Kernel (Math 
Mode). 

Relational -< symbol. [§9.4] 

\preceq 

Defined in: ETgX Kernel (Math 
Mode). 

Relational < symbol. [§9.4] 


\printindex 

Defined in: makeidx package. 

Prints the index. Must be used 
with \makeindex and \index. (The 
external index file must first be 
processed by an indexing 
application.) [§8.0] 

\prod 

Defined in: RTpX Kernel (Math 
Mode). 

Product Y\ symbol (may take 
limits). [§9.4] 

\projlim 

Defined in: amsmath (Math Mode). 

Typesets proj lim function name 
(may hâve limits via _ or A ). [§9.4] 

\propto 

Defined in: ETp;X Kernel (Math 
Mode). 

Relational oc symbol. [§9.4] 

\protect(command) 

Defined in: RI^X Kernel. 

Used in a moving argument to 
prevent a fragile command from 
expanding. [§2.9] 

\Psi 

Defined in: ETgX Kernel (Math 
Mode). 

Greek upper case psi T. [§9.4] 

\psi 

Defined in: ETp;X Kernel (Math 
Mode). 
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Greek lower case psi ip. [§9.4] 

\publishers {(text)} 

Defined in: scrartcl, scrreprt, scrbook 

classes. 

Spécifiés the publisher (typeset 
after ail the other titling 
information). [§5.1] 

Q 

\qquad 

Defined in: ETgX Kernel. 

Horizontal spacing command 
(twice as wide as \quad). [§9.4] 

\quad 

Defined in: Ed^X Kernel. 

Horizontal spacing command equal 
to the current font's em value. 

[§9.4] 

R 

\r{(c)} 

Defined in: ETgX Kernel. 

Ring over (c). Example: \r{u} 
produces u. [§4.3] 

\raggedleft 

Defined in: ETgX Kernel. 

Ragged-left paragraph justification. 

[§ 2 . 12 ] 

\raggedright 

Defined in: ETgX Kernel. 

Ragged-right paragraph 
justification. [§2.12] 

\rangle 

Defined in: ETgX Kernel (Math 
Mode). 


Right-angled ) délimiter. [§9.4] 
\rceil 

Defined in: ETgX Kernel (Math 
Mode). 

Right ceil ] délimiter. [§9.4] 

\ref{ (string)} 

Defined in: Ed^X Kernel. 

References the value of the 
counter linked to the given label. A 
second (possibly third) run of ETgX 
is required to ensure the 
cross-references are up-to-date. 
[§5.5] 

\reflectbo x{(text)} 

Defined in: graphicx package. 

Reflects the specified contents in 
the y-axis.) [§6.1] 

\refname 

Defined in: Article style classes 
that define a bibliography section. 

Text used for bibliography section 
heading. (See also \bibname.) [§8.2] 

\refstepcounter{(counfer}} 

Defined in: ETgX Kernel. 

Incréments the value of the given 
counter by one and allows the 
counter to be cross-referenced 
using \ref and \label. [§11.0] 

\renewcommand{ (cmd)} [(n-args)] 
l(default)l{(text )} 

Defined in: ETgX Kernel. 

Redefines an existing command. 

[§ 8 . 2 ] 
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\r enewenvi ronment { ( env-name}} 
[(n-argrs)] [( default)] {(begin- 
code}} {end-code} 

Defined in: ETgX Kernel. 

Redefines an existing environment. 

[§ 10 . 1 ] 

\resizebox{(h length)}{(v 
length)} {(text)} 

Defined in: graphicx package. 

Scales the specified contents to the 
given dimensions. [§6.1] 

\rfloor 

Defined in: ETgX Kernel (Math 
Mode). 

Right floor J délimiter. [§9.4] 

\rho 

Defined in: ETgX Kernel (Math 
Mode). 

Greek lower case rho p. [§9.4] 

\right (délimiter) 

Defined in: ETgX Kernel (Math 
Mode). 

Indicates a right stretchable 
délimiter. Must hâve a matching 
\left. [§9.4] 

\Rightarrow 

Defined in: ETgX Kernel (Math 
Mode). 

Double-lined right arrow =#. [§9.4] 
\rightarrow 

Defined in: ETgX Kernel (Math 
Mode). 

Right arrow —». [§9.4] 


\rightharpoondown 

Defined in: ETgX Kernel (Math 
Mode). 

Right down harpoon —r. [§9.4] 

\rightharpoonup 

Defined in: ETgX Kernel (Math 
Mode). 

Right up harpoon — [§9.4] 

\rightleftharpoons 

Defined in: ETgX Kernel (Math 
Mode). 

Right-left harpoons [§9.4] 
\rmdefault 

Defined in: ETgX Kernel. 

The name of the default serif 
family as used by \rmfamily. 
Defaults to cmr (Computer Modem 
Roman). [§8.2] 

\rmfamily 

Defined in: ETpX Kernel. 

Switches to the predefined serif 
font. (Defaults to Computer 
Modem Roman.) [§4.5] 

\Roman {(counter ) } 

Defined in: ETgX Kernel. 

Displays counter value as an upper 
case Roman number. (I, II, III, ... ) 
[§ 11 . 0 ] 

\roman{ (counter ) } 

Defined in: BTpX Kernel. 

Displays counter value as a lower 
case Roman number. (i, ii, iii, ...) 
[§ 11 . 0 ] 
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\rotatebox [(option 
list )] {(angle)} {(text)} 

Defined in: graphicx package. 

Rotâtes the given contents by the 
given angle. [§6.1] 

\rVert 

Defined in: amsmath (Math Mode). 

Right double vertical bar [] 
délimiter. [§9.4] 

\rvert 

Defined in: amsmath (Math Mode). 
Right vertical bar ] délimiter. [§9.4] 

S 

\s 

Defined in: ETgX Kernel. 

Sectional § symbol. [§4.3] 

\sb {(maths)} 

Defined in: ETgX Kernel (Math 
Mode). 

Displays its argument as a 
subscript. [§9.4] 

\scalebox{(h scale)}[(v 
scale)} {(text)} 

Defined in: graphicx package. 

Scales the specified contents. [§6.1] 

\scriptsize 

Defined in: Most document 
classes. 

Switches to sub- or superscript 
sized text. [§4.5] 

\scshape 

Defined in: ETgX Kernel. 


Switches to the small-caps form of 
the current font family, if it exists. 
[§4-5] 

\searrow 

Defined in: Kernel (Math 

Mode). 

South-East arrow \. [§9.4] 

\sec 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets sec function name. [§9.4] 

\section {(short title)} {(title)} 

Defined in: Most classes that hâve 
the concept of document structure. 

Inserts a section header. This 
command has a moving 
argument. [§5.3] 

\selectlanguag e{(language 
name)} 

Defined in: babel package. 

Switches to the named language. 
Predefined textual éléments, such 
as the date given by \today or 
préfixés like "Chapter", are 
redefined to those supplied by the 
given language. [§5.8] 

\setcounter{(counfer}} 

{(number)} 

Defined in: Kernel. 

Sets the value of a counter. [§11.0] 

\setlength {(register)} 
{(dimension)} 

Defined in: ETgX Kernel. 

Sets the value of a length register. 
[§2.17] 
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\setminus 

Defined in: ETgX Kernel (Math 
Mode). 

Operator \ Symbol. [§9.4] 
\sfdefault 

Defined in: ETgX Kernel. 

The name of the default sans-serif 
family as used by \sffamily. 
Defaults to cmss (Computer 
Modem Sans-serif). [§8.2] 

\sffamily 

Defined in: ETgX Kernel. 

Switches to the predefined 
sans-serif font. (Defaults to 
Computer Modem Sans.) [§4.5] 

\ shado wbox { ( text ) } 

Defined in: fancybox package. 

Puts a shadow frame around its 
contents, prohibiting a line break 
in the contents. [§4.7] 

\begin{sidewaysfigure} 

Defined in: rotating package. 

Like the figure environment but 
rotâtes the entire figure (including 
caption) sideways. [§7.3] 

\begin{sidewaystable} 

Defined in: rotating package. 

Like the table environment but 
rotâtes the entire table (including 
caption) sideways. [§7.3] 

\Sigma 

Defined in: ETgX Kernel (Math 
Mode). 


Greek upper case sigma X. [§9.4] 
\sigma 

Defined in: ETgX Kernel (Math 
Mode). 

Greek lower case sigma a. [§9.4] 
\sim 

Defined in: ETgX Kernel (Math 
Mode). 

Relational ~ Symbol. [§9.4] 

\simeq 

Defined in: ETgX Kernel (Math 
Mode). 

Relational ~ Symbol. [§9.4] 

\sin 

Defined in: RTpX Kernel (Math 
Mode). 

Typesets sin function name. [§9.4] 
\sinh 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets sinh function name. [§9.4] 
\slash 

Defined in: ETgX Kernel. 

Forward slash / symbol. [§4.3] 

\slshape 

Defined in: ETp;X Kernel. 

Switches to the slanted form of the 
current font family, if it exists. 

[§4-5] 
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\small 

Defined in: Most document 
classes. 

Switches to small sized text. [§4.5] 

\begin{smallmatrix} 

Defined in: amsmath package 
(Math Mode). 

Like the array environment but 
doesn't hâve an argument and is 
designed for in-line maths. [§9.4] 

\smile 

Defined in: KI^X Kernel (Math 
Mode). 

Relational w symbol. [§9.4] 

\sp {(maths)} 

Defined in: ËTgX Kernel (Math 
Mode). 

Displays its argument as a 
superscript. [§9.4] 

\sqcap 

Defined in: ETgX Kernel (Math 
Mode). 

Operator n symbol. [§9.4] 

\sqcup 

Defined in: ETp;X Kernel (Math 
Mode). 

Operator U symbol. [§9.4] 

\sqrt [(order)] {( operand )} 

Defined in: ETgX Kernel (Math 
Mode). 

Displays a root. [§9.4] 


\sqsubseteq 

Defined in: ETgX Kernel (Math 
Mode). 

Relational Ç symbol. [§9.4] 
\sqsupseteq 

Defined in: ETgX Kernel (Math 
Mode). 

Relational □ symbol. [§9.4] 

\SS 

Defined in: ETpX Kernel. 

SS (upper case K). [§4.3] 

\ss 

Defined in: ETgX Kernel. 

Eszett K character. [§4.3] 

\star 

Defined in: ETgX Kernel (Math 
Mode). 

Operator * symbol. [§9.4] 

\stepcounter{(counfer}} 

Defined in: ETp;X Kernel. 

Incréments the value of the given 
counter by one. [§11.0] 

\begin{subfigure} [(pos)] 

{( width )} 

Defined in: subcaption package. 

Used to form a subfigure within a 
figure environment. The \caption 
command may be used in this 
environment to produce a 
subcaption. [§7.4] 
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\subject {(text)} 

Defined in: scrartcl, scrreprt, scrbook 

classes. 

Spécifiés the subject (typeset just 
above the title). [§5.1] 

\subparagraph [(shorf 
title)] {(title)} 

Defined in: Most classes that hâve 
the concept of document structure. 

Inserts a subsubsubsubsection 
header. Most classes default to an 
unnumbered running header for 
this sectional unit. This command 
has a moving argument. [§5.3] 

\subref{(label}} 

Defined in: subcaption package. 

Analogous to \ref but only 
references the subfigure or 
subtable caption. [§7.4] 

\subsection {(short title)] {(title)} 

Defined in: Most classes that hâve 
the concept of document structure. 

Inserts a subsection header. This 
command has a moving 
argument. [§5.3] 

\subset 

Defined in: ETgX Kernel (Math 
Mode). 

Subset c symbol. [§9.4] 

\subseteq 

Defined in: ETgX Kernel (Math 
Mode). 

Relational C symbol. [§9.4] 


\substack {(maths)} 

Defined in: amsmath package. 

Can be used to produce a multiline 
subscript or superscript. Lines are 
separated using \\. [§9.4] 

\subsubsection {(short 
title)] {(title)} 

Defined in: Most classes that hâve 
the concept of document structure. 

Inserts a subsubsection header. 

This command has a moving 
argument. [§5.3] 

\begin{subtable} [(pos)] 

{(width)} 

Defined in: subcaption package. 

Used to form a subtable within a 
table environment. The \caption 
command may be used in this 
environment to produce a 
subcaption. [§7.4] 

\subtitle{(fexf)} 

Defined in: scrartcl, scrreprt, scrbook 

classes. 

Spécifiés the subtitle (typeset just 
below the title). [§5.1] 

\succ 

Defined in: ETgX Kernel (Math 
Mode). 

Relational >- symbol. [§9.4] 

\succeq 

Defined in: UTgX Kernel (Math 
Mode). 

Relational > symbol. [§9.4] 
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\sum 

Defined in: ETgX Kernel (Math 
Mode). 

Summation XI Symbol (may take 
limits). [§9.4] 

\sup 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets sup function name (may 
hâve limits via _ or A ). [§9.4] 

\supset 

Defined in: EI^X Kernel (Math 
Mode). 

Relational D Symbol. [§9.4] 
\supseteq 

Defined in: ETp;X Kernel (Math 
Mode). 

Relational D symbol. [§9.4] 
\swarrow 

Defined in: RTgX Kernel (Math 
Mode). 

South-West arrow y. [§9.4] 

T 

\ t { ( charac ter s ) } 

Defined in: ETgX Kernel. 

Tie over ( characters). Example: 
\t{xy} produces xÿ. [§4.3] 

\tabcolsep 

Defined in: ETgX Kernel. 

Length register specifying half the 
gap between columns in a tabular 
environment. [§4.6] 


\begin{table} [( placement )] 

Defined in: Most classes that 
define sectioning commands. 

Floats the contents to the nearest 
location according to the preferred 
placement options, if possible. 
Within the environment, \caption 
may be used one or more times, as 
required. The caption will usually 
include the prefix given by 
\tablename. [§7.2] 

\tablename 

Defined in: Classes or packages 
that define tables. 

Number prefix used in table 
captions. [§8.2] 

\tableof contents 

Defined in: Most classes that hâve 
the concept of document structure. 

Inserts the table of contents. A 
second (possibly third) run is 
required to ensure the page 
numbering is correct. [§5.4] 

\begin{tabular} [(v-pos)] 

{( column 
specifiers )} 

Defined in: ETgX Kernel (Text 
Mode). 

Environment for lining things up 
in rows and columns. Use array for 
math mode. [§4.6] 

\tabularnewline 

Defined in: EI^X Kernel. 

Behaves like \\ in a tabular-like 
environment but helps to 
disambiguate a line break in a 
paragraph cell from a row 
separator. [§4.6] 
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\tag {(tag)} 

Defined in: amsmath package. 

Overrides équation numbering for 
the current row in environments 
such as align. [§9.3] 

\tan 

Defined in: Kernel (Math 

Mode). 

Typesets tan function name. [§9.4] 
\tanh 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets tanh function name. [§9.4] 
\tau 

Defined in: ETgX Kernel (Math 
Mode). 

Greek lower case tau r. [§9.4] 

\TeX 

Defined in: ETgX Kernel. 

Typesets the TgX logo. [§2.6] 

\text{(fexf)} 

Defined in: amsmath package 
(Math Mode). 

Displays its argument in the 
normal text font (as opposed to the 
current maths font). [§9.2] 

\textasciicircum 
Defined in: ETgX Kernel. 
Circumflex A Symbol. [§4.3] 

\textascii tilde 
Defined in: ETgX Kernel. 


Tilde — Symbol. (If you are typing 
an URL, use the url package, which 
provides \url {(address)} that 
allows you to directly type — in the 
address.) [§4.3] 

\textbackslash 

Defined in: ETgX Kernel (Text 
Mode). 

Backlash \ Symbol. (Use 
\backslash for math mode.) [§4.3] 

\textbar 

Defined in: ETp;X Kernel. 

Vertical bar | symbol. [§4.3] 

\textbf{(fexf)} 

Defined in: ETp;X Kernel. 

Renders (text) with a bold weight 
in the current font family, if it 
exists. [§4.5] 

\textbullet 

Defined in: ETj;X Kernel (Text 
Mode). 

Bullet • symbol. [§4.3] 

\textcolor [(mode!)] {( specs )} 
{(text)} 

Defined in: color and xcolor 

packages. 

Sets (text) with the foreground 
colour according to the given 
(specs). [§8.0] 

\textemdash 

Defined in: ETgX Kernel. 

Em-dash — symbol. (Normally 
used to indicate omissions or 
interruptions or to highlight a 
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parenthetical element.) See also 
—• [§4.3] 

\textendash 

Defined in: ETgX Kernel. 

En-dash - Symbol. (Normally used 
for number ranges.) See also 

[§4.3] 

\textexclamdown 

Defined in: ETgX Kernel. 

Upside-down exclamation mark j 
symbol. [§4.3] 

\textgreater 

Defined in: ETgX Kernel (Text 
Mode). 

Greater than > symbol. (Just use > 
in math mode.) [§4.3] 

\textheight 

Defined in: ETgX Kernel. 

A length containing the height of 
the typeblock. Note that the actual 
contents of the page may fall short 
of the text height (underfull vbox) 
or extend beyond it (overfull vbox). 
This measurement does not 
include the header and footer 
areas. [§6.0] 


Less than < symbol. (Just use < in 
math mode.) [§4.3] 

\textmd{(fexf)} 

Defined in: ETgX Kernel. 

Renders (text) with a medium 
weight in the current font family. 
[§4-5] 

\textnormal {(text)} 

Defined in: ETgX Kernel. 

Renders (text) in the default font 
style. [§4.5] 

\textperiodcentered 

Defined in: BTgX Kernel (Text 
Mode). 

Centred period • symbol. [§4.3] 

\textquestiondown 

Defined in: RI^X Kernel. 

Upside-down question mark £ 
symbol. [§4.3] 

\textquotedblleft 
Defined in: ETgX Kernel. 
Opening double quote " symbol. 

[§4.3] 
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\textit{(fexf}} 

Defined in: RI^X Kernel. 

Renders (text) with the italic form 
of the current font family, if it 
exists. [§4.5] 

\textless 

Defined in: ETgX Kernel (Text 
Mode). 


\textquotedblright 
Defined in: ETp;X Kernel. 
Closing double quote " symbol. 

[§4.3] ‘ 

\textquoteleft 
Defined in: ETgX Kernel. 
Opening single quote ' symbol. 

[§4-3] 
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\textquoteright 

Defined in: ETp;X Kernel. 

Closing single quote (or 
apostrophe) ' Symbol. [§4.3] 

\textregistered 
Defined in: ETgX Kernel. 
Registered ® symbol. [§4.3] 

\textrm{(fexf)} 

Defined in: ETgX Kernel. 

Renders ( text) in the predefined 
serif font. (Defaults to Computer 
Modem Roman.) [§4.5] 

\textsc{(fexf}} 

Defined in: ETgX Kernel. 

Renders (text) with the small-caps 
form of the current font family, if 
it exists. [§4.5] 

\textsf {(text)} 

Defined in: ETgX Kernel. 

Renders (text) in the predefined 
sans-serif font. (Defaults to 
Computer Modem Sans.) [§4.5] 

\textsl{(fexf)} 

Defined in: ETgX Kernel. 

Renders (text) with the slanted 
form of the current font family, if 
it exists. [§4.5] 

\texttrademark 
Defined in: ETp;X Kernel. 
Trademark ™ Symbol. [§4.3] 


\texttt{(fexf)} 

Defined in: ETgX Kernel. 

Renders (text) in the predefined 
monospaced font. (Defaults to 
Computer Modem Typewriter.) 
[§4-5] 

\textunder score 

Defined in: ETp;X Kernel. 

Underscore _ Symbol (see also 
\textunderscore). [§4.3] 

\textup{(fexf)} 

Defined in: EI^X Kernel. 

Renders (text) with the upright 
form of the current font family. 
[§4-5] 

\textwidth 

Defined in: ETgX Kernel. 

A length containing the width of 
the typeblock. Note that the actual 
contents of the line may fall short 
of the line width (underfull hbox) 
or extend beyond it (overfull hbox). 
This width does not include the 
area for marginal notes. [§2.17] 

\thanks{(fexf}} 

Defined in: Most classes that hâve 
the concept of a title page. 

Inserts a spécial type of footnote in 
one of the titling fields, such as 
\author or \title. Usually used 
for some form of 
acknowledgement or affiliation. 

[§5.1] 

\the (register) 

Defined in: ETgX Kernel. 
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Displays the value of the given 
register (such as a length register). 
Not to be confused with \the(cfr) 
commands, such as \thefigure. 
[§2.17] 

\begin{thebibliography }{(widest 
entry label}} 

Defined in: Most classes that 
define sectioning commands. 

Bibliographie list. (See also 
\bibitem and \cite). [§5.6] 

\thechapter 

Defined in: ETgX Kernel. 

Displays the current value of the 
chapter counter [§11.0] 

\thefigure 

Defined in: Kernel. 

Displays the current value of the 
figure counter [§11.0] 

\thefootnote 

Defined in: ETgX Kernel. 

Displays the current value of the 
footnote counter [§11.0] 

\thepage 

Defined in: ETgX Kernel. 

Displays the current value of the 
page counter [§11.0] 

\thesection 

Defined in: ETgX Kernel. 

Displays the current value of the 
section counter [§11.0] 


\Theta 

Defined in: EŒ^X Kernel (Math 
Mode). 

Greek upper case thêta ©. [§9.4] 
\theta 

Defined in: EŒ^X Kernel (Math 
Mode). 

Greek lower case thêta 9 . [§9.4] 
\thickspace 

Defined in: amsmath package. 
Thick space. [§9.4] 

\thinspace 

Defined in: ETp;X Kernel. 

Thin space. [§9.4] 

\thispagestyl e{(style)} 

Defined in: ETpX Kernel. 

Like \pagestyle but only affects 
the current page. [§5.7] 

\times 

Defined in: ETp;X Kernel (Math 
Mode). 

Operator x symbol. [§9.4] 

\tiny 

Defined in: Most document 
classes. 

Switches to tiny sized text. [§4.5] 
\title{(fexf}} 

Defined in: Most classes that hâve 
the concept of a title page. 

Spécifiés the document title. This 
command doesn't display any text 
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so may be used in the preamble, 
but if it's not in the preamble it 
must be placed before \maketitle. 

[§5.1] 

\titlehead{(fexf}} 

Defined in: scrartcl, scrreprt, scrbook 

classes. 

Spécifiés the title header (typeset at 
the top of the title page). [§5.1] 

\to 

Defined in: ETgX Kernel (Math 
Mode). 

Right arrow [§9.4] 

\today 

Defined in: Most of the 
commonly-used classes. 

Inserts into the output file the date 
when the ETgX application created 
it from the source code. [§4.1] 

\toprule [(wd)] 

Defined in: booktabs package. 

Horizontal rule for the top of a 
tabular environment. [§4.6] 

\triangleleft 

Defined in: ETgX Kernel (Math 
Mode). 

Binary operator < Symbol. [§9.4] 
\triangleright 

Defined in: ETgX Kernel (Math 
Mode). 

Binary operator o symbol. [§9.4] 


\ttdefault 

Defined in: ETgX Kernel. 

The name of the default typewriter 
family as used by \ttfamily. 
Defaults to cmtt (Computer 
Modem Typewriter). [§8.2] 

\ttfamily 

Defined in: ETp;X Kernel. 

Switches to the predefined 
monospaced font. (Defaults to 
Computer Modem Typewriter.) 
[§4-5] 

U 

\u{(c}} 

Defined in: ETgX Kernel. 

Breve diacritic over (c). Example: 
\u{o} produces ô. [§4.3] 

\underleftarrow {(maths)} 

Defined in: amsmath package 
(Math Mode). 

Puts an extendible left arrow 
under (maths) [§9.4] 

\underleftrightarrow {(maths)} 

Defined in: amsmath package 
(Math Mode). 

Puts an extendible left-right arrow 
under (maths) [§9.4] 

\underrightarrow {(maths)} 

Defined in: amsmath package 
(Math Mode). 

Puts an extendible right arrow 
under (maths) [§9.4] 

\Uparrow 

Defined in: ETgX Kernel (Math 
Mode). 
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Double-lined up arrow f. (May be 
used as a délimiter.) [§9.4] 

\uparrow 

Defined in: Ed^gX Kernel (Math 
Mode). 

Up arrow j\ (May be used as a 
délimiter.) [§9.4] 

\Updownarrow 

Defined in: ETgX Kernel (Math 
Mode). 

Double-ended double-lined vertical 
arrow f. (May be used as a 
délimiter.) [§9.4] 

\updownarrow 

Defined in: ETgX Kernel (Math 
Mode). 

Double-ended vertical arrow |. 
(May be used as a délimiter.) [§9.4] 

\uplus 

Defined in: ETgX Kernel (Math 
Mode). 

Operator W Symbol. [§9.4] 

\upshape 

Defined in: Ed^X Kernel. 

Switches to the upright form of the 
current font family. [§4.5] 


Greek lower case upsilon v. [§9.4] 

\url {(address)} 

Defined in: url package. 

Typesets an URL in a typewriter 
font and allows you to use 
characters such as ~. [§4.5] 

\usepackage [(option-list)] 

{( package-list )} 

Defined in: ETgX Kernel. 

Loads the named packages. [§4.2] 

V 

\v{(c}} 

Defined in: ETgX Kernel. 

Caron diacritic over (c). Example: 
\v{o} produces ô. [§4.3] 

\value { ( counter) } 

Defined in: ETgX Kernel. 

References the value of the given 
counter where a number rather 
than a counter name is required. 
[§ 11 . 0 ] 

\varepsilon 

Defined in: ETgX Kernel (Math 
Mode). 

Variant Greek lower case alpha e. 
[§9-4] 
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\Upsilon 

Defined in: ETgX Kernel (Math 
Mode). 

Greek upper case upsilon Y. [§9.4] 
\upsilon 

Defined in: ETgX Kernel (Math 
Mode). 


\varinjlim 

Defined in: amsmath (Math Mode). 

Typesets lim function name (may 
hâve limits via _ or A ). [§9.4] 

\varliminf 

Defined in: amsmath (Math Mode). 
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Typesets lim function name (may 
hâve limits via _ or A ). [§9.4] 


\varlimsup 

Defined in: amsmath (Math Mode). 

Typesets lim function name (may 
hâve limits via _ or A ). [§9.4] 


\varphi 

Defined in: ETgX Kernel (Math 
Mode). 

Variant Greek lower case phi cp. 
[§9.4] 


\varpi 

Defined in: ETgX Kernel (Math 
Mode). 

Variant Greek lower case pi a). 
[§9.4] 


\varprojlim 

Defined in: amsmath (Math Mode). 

Typesets lim function name (may 
hâve limits via _ or A ). [§9.4] 


\varrho 

Defined in: ETgX Kernel (Math 
Mode). 

Variant Greek lower case rho q. 

[§9.4] 


\varsigma 

Defined in: ETp;X Kernel (Math 
Mode). 

Variant Greek lower case sigma ç. 
[§9.4] 


\vartheta 

Defined in: ETgX Kernel (Math 
Mode). 


A variant Greek lower case thêta 
û. [§9.4] 


\vdash 

Defined in: ETp;X Kernel (Math 
Mode). 

Relational h symbol. [§9.4] 


\vdots 

Defined in: ETgX Kernel (Math 
Mode). 

Vertical ellipses : symbol. [§9.4] 


\vec{(c}} 

Defined in: ETgX Kernel (Math 
Mode). 

Typesets its argument as a vector 
(defaults to a right arrow accent). 

[§9.4] 


\vee 

Defined in: ETpX Kernel (Math 
Mode). 

Operator V symbol. [§9.4] 


\begin{Vmatrix} 

Defined in: amsmath package 
(Math Mode). 

Like the array environment, but 
doesn't hâve an argument and adds 
double vertical bar delimiters. 

[§9.4] 
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\begin{vmatrix} 

Defined in: amsmath package 
(Math Mode). 

Like the array environment, but 
doesn't hâve an argument and adds 
single vertical bar delimiters. [§9.4] 
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\vref{ (string)} 

Defined in: varioref package. 

Like \ref but also adds 
information about the location, 
such as "on page (n)" or "on the 
following page". [§5.5] 

\vspac e { ( length)} 

Defined in: ETgK Kernel. 

Inserts a vertical gap of the given 
height. [§11.0] 

W 

\wedge 

Defined in: Kernel (Math 

Mode). 

Operator A Symbol. [§9.4] 


\xrightarrow [(subscript )] 
{(superscript}} 

Defined in: amsmath package 
(Math Mode). 

An extendible right arrow with a 
superscript and optionally a 
subscript. [§9.4] 

Z 

\zeta 

Defined in: ETp;X Kernel (Math 
Mode). 

Greek lower case zêta C,. [§9.4] 


\wr 

Defined in: fflpX Kernel (Math 
Mode). 

Operator l Symbol. [§9.4] 

X 

\Xi 

Defined in: ETgX Kernel (Math 
Mode). 

Greek upper case xi H. [§9.4] 


\xi 

Defined in: ETgX Kernel (Math 
Mode). 

Greek lower case xi [§9.4] 
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\xleftarrow [(subscript)} 
{(superscript)} 

Defined in: amsmath package 
(Math Mode). 

An extendible left arrow with a 
superscript and optionally a 
subscript. [§9.4] 
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45, 206 
14, 16, 44, 206 
44, 160, 167, 206 
14, 16, 44, 206 
44, 59, 89, 116, 123, 206 


\AA 

46, 206 

\aa 

46, 206 

abstract 

62, 81, 103 

abstract environment 

81, 102, 104, 

206 


\abstractname 

138, 206 

Active Perl 

26 

\addcont ent s1ine 

86, 98, 207 

\addto 

137, 207 

\addtocounter 

177, 193, 207 

\addtokomafont 

84, 116, 207 

\addtolength 

24, 207 

Adobe Reader 

27 

\AE 

46, 207 

\ae 

46, 207 

align environment 

144, 145, 207, 


215, 220, 227, 239 


argument 15, 17, 18, 42, 88, 128, 
138, 189, 192, 193 
mandatory 16, 17, 38, 46, 69, 82, 
100, 127, 149, 176, 192-194 
moving 17,8 0,114 

optional 38, 43, 55, 82, 99, 100, 

108, 127, 189, 193, 204, 206 
array environment 166, 168, 189, 

203, 206, 208, 211, 212, 225, 

230, 236, 238, 245 

array package 65, 66, 189, 203 

\arraycolsep 166, 208 

\ast 156, 208 

\asymp 155, 208 

\author 79, 207, 209, 241 

auxiliary file (. aux) 9, 91 


B 


\b 46, 209 

babel package 22, 105, 137, 207, 217, 
219, 228, 234 

english 138 

french 106 

\backmatter 102, 209, 218, 224 
\backslash 160, 209, 239 


align* environment 

144, 207 

\baselineskip 


173, 209 

\Alph 

178, 207 

beamer class 


38 

\alph 

178, 207 

\begin 23, 162, 

186, 193, 

209, 216 

\alpha 

148, 207 

\beta 


148, 209 

\amalg 

156, 207 

\bfseries 14, 15, 18, 60, 

116, 209 

amsfonts package 

147, 169, 225 

bfseries environment 

23, 209 

amsmath package 

43, 140- 

biber 


97 

171, 205, 207, 210-212, 214- 

\bibitem 97, 

100, 194, 

209, 242 

216, 220, 224- 

-227, 229-231, 234, 

\bibname 

98, 138, 209, 232 

236, 237, 239, 242-246 

BibT E X 


5 

\and 

79, 207 

bibtex 

11, 26, 97 

anttor package 

64, 137 

\bigcap 


157, 209 

\appendix 

83, 207 

\bigcirc 


156, 210 

\appendixname 

138, 208 

\bigcup 


157, 210 

\approx 

155, 208 

\Biggl 


161, 210 

\appto 

138, 208 

\biggl 


161, 210 

\arabic 

178, 208 

\Biggr 


161, 210 

\arccos 

150, 208 

\biggr 


161, 210 

\arcsin 

150, 208 

\Bigl 


161, 210 

\arctan 

150, 208 

\bigl 


161, 210 

\arg 

150, 208 

\bigodot 


157, 210 



\bigoplus 


157, 210 
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\bigotimes 

157, 210 

17pt (KOMA) 

63 

Symbols 

\Bigr 

161, 210 

2©pt (KOMA) 

63 

A 

\bigr 

161, 210 

8pt (KOMA) 

63 

B 

\bigsqcup 

157, 210 

9pt (KOMA) 

63 

JL J 

r> 

\bigtriangledown 

156, 211 

bibliography (KOMA) 98 


\bigtriangleup 

156, 211 

captions (KOMA) 

119 

D 

\biguplus 

157, 211 

draft 

43 

E 

\bigvee 

157, 211 

letterpaper 

oneside 

8, 38 

103, 104 

F 

\bigwedge 

157, 211 

parskip (KOMA) 

25, 41, 230 

G 

Bmatrix environment 

168, 211 

toc (KOMA) 

85, 87 

H 

bmatrix environment 

168, 170, 211 

twocolumn 

38 

I 

\bmod 

150, 211 

twoside 

103, 104, 121 

T 

\boldsymbol 147, 169, 211, 225, 231 

class files (.cls) 

59, 81, 82, 111 

J 

booktabs package 70, 211, 218, 222, 

beamer 

38 

K 

226, 243 


jmlr 

38 

L 

\bottomrule 

70, 211, 218 

memoir 

3, 4, 38, 206 

M 

\bowtie 

155, 211 

scrartcl 

8, 38, 43, 

M 

bp (big point) 

24, 108 

55, 82, 84, 103, 

119, 138, 206, 

IM 

\bullet 

156, 211 

207, 226, 232, 237, 243 

O 



scrbook 

10, 26, 38, 

P 

C 


81, 82, 98, 102- 

104, 119, 121, 




138, 178, 206, 

207, 209, 212, 

M 

\c 46, 47, 135, 211 

218, 224, 226, 232, 237, 243 

R 

\cap 

156, 211 

scrreprt 

25, 38, 81-84, 

S 

\caption 114, 116, 

118, 119, 121, 

86, 98, 103, 119, 

138, 206, 207, 

T 

212, 217, 236-238 

212, 226, 232, 237, 243 

JL 

caption package 121, 

124, 212, 214 

cm (centimètre) 

24 

U 

\captionsetup 

124, 212 

\color 

129, 212 

V 

labelformat 

124 

color package 129, 

131, 212, 239 

w 

cases environment 

167, 212 

colortbl package 

72 

X 

cc (cicero) 

24 

command 7, il, 14- 

-18, 23, 24, 26, 

\7 

\cdot 

156, 212 

38, 39, 41, 42, 

48, 59, 62, 79, 

Y 

rw 

\cdots 

158, 212 

126, 147, 187, 190, 195 

Z 

\centering 18, 115, 
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character sequence 14 


\cfrac 

152, 212 

control symbol 

13 


\chapter 13, 15, 82, 

82, 83, 85, 86, 

control word 

12 


102, 105, 176, 212 

fragile 

17, 114, 141 


\chaptername 

138, 212 

internai 

14 


\chi 

148, 212 

long 

18 


. 

A RR OA O 

modal 

59 


\circ 

lOO, Z JL Z 

robust 

18, 141 


\cite 

99, 212, 242 

short 18, 130, 

133, 135, 193 


class file 8, 10, 26, 38, 62, 82, 103 

starred 

13 


class file options 


text-block 

59 


10pt 

63 

command prompt 



llpt 

38 

see terminal 



12pt 

38, 63 

\cong 

155, 213 


14pt (KOMA) 

63 

\contentsname 

138, 213 
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\coprod 

157, 213 

\copyright 

45, 213 

\cos 

150, 213 

\cosh 

150, 213 

\cot 

150, 213 

\coth 

150, 213 

counters 

176 

chapter 

176, 178, 179, 242 

équation 

176 

figure 

176, 242 

footnote 

176, 179, 242 

page 

176, 242 

section 

242 

table 

176 

courier package 

63, 64 

\csc 

150, 213 

CTAN 

3, 4, 6, 180, 201 

\cup 

156, 213 

\currenttime 

43, 213 


D 

\d 

46, 213 

\dag 

45, 135, 213 

\dagger 

156, 213 

\dashv 

155, 213 

\date 

79, 214 

datetime package 

43, 44, 213, 214 

12hr 

43 

24hr 

44 

level 

43 

nodayofweek 

43 

short 

43 

dd (didôt point) 

24 

\ddag 

45, 49, 214 

\ddagger 

156, 214 

\ddmmyyyydat e 

43, 214 

\ddots 

158, 214 

déclaration 18, 59, 62, 67, 105, 129 


\DeclareCaptionLabelFormat 124, 
214 

\DeclareGraphicsExtensions 108, 
214 

\DeclareMathOperator 151, 214 
\def 134 

\deg 150, 214 

\Delta 148, 154, 214 
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\delta 

148, 214 

description environment 

55, 56, 214 

\det 

150, 214 

detexify 

46 

\diamond 

156, 215 

\dim 

150, 215 

\ding 

136, 215 

dinglist environment 

136, 215 

directory divider 

108, 188, 196 

\displaybreak 

144, 215 

displayed maths 

140 

\div 

156, 215 

document environment 

24, 38, 79, 

137, 215 


\documentclass 13, 

14, 24, 26, 38, 

42, 43, 188, 191, 215 

\doteq 

155, 215 

\dotsb 

158, 215 

\dotsc 

158, 215 

\dotsi 

158, 215 

\dotsm 

158, 215 

\dotso 

158, 215 

\doublebox 

77, 215 

\Downarrow 

156, 160, 216 

\downarrow 

156, 160, 216 

DVI file 

9 
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ellipses (omission marks) 158 

\em 

60, 62, 216 

em environment 

62, 216 

em (relative unit) 

24 

Emacs 

27 

\emph 

60, 62, 216 

en-space 

20 

Encapsulated PostScript (EPS) file 26, 


107 

\end 23, 162, 185, 186, 209, 216 
English spacing 

see spacing, English 
\enspace 20, 216 

enumerate environment 53, 54, 56, 
90, 216 

environment 15, 23, 24, 26, 38, 48, 
59, 62, 63, 140, 172, 187, 188, 
190, 192-194 

\epsilon 148, 216 
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epstopdf 

26, 107 

\frenchspacing 

20, 217 

Symbols 

\eqref 

143, 216 

front-end 

27 

A 

équation environment 

143, 145, 176, 

\frontmatter 102, 

104, 209, 218, 

B 

187, 216 


224 


\equiv 

155, 216 

\frown 

155, 218 

C 

\eta 

148, 216 

ri 


D 

etoolbox package 

138, 208 

VJ 


E 

Evince 

27 

\Gamma 

148, 218 

F 

ex (relative unit) 

24, 109 

\gamma 

148, 218 

G 

\exp 

150, 217 

\gcd 

150, 218 

M 



\ge 

155, 218 

xJL 

F 


Gedit 

27 

I 

\familydefault 

136, 217 

geometry package 

25 

J 

fancybox package 76, 215, 229, 235 

\geq 

155, 218 

K 

\fbox 

76, 217 

\gets 

156, 218 

L 

ffi 

46 

\gg 

155, 218 

M 

ffl 

46 

glossaries package 

3 

N 

fi 

46 

glue 

72 

figure environment 

115, 117, 121, 

graphicx package 43, 

107, 110-112, 

O 

176, 217, 235, 236 

115, 214, 219, 232-234 

P 

\figurename 

138, 217 
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43, 111 
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final 

111 

R 
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9, 91 

hiderotate 
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XV 

Q 
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39, 81, 82, 111 

hidescale 

111 

O 

. eps 

26, 107 

grffile package 
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T 

.lof 

10, 86, 117 
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Copyright © 2000,2001,2002 Free Software Foundation, Inc. 

51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA 

Everyone is permitted to copy and distribute Verbatim copies of this 
license document, but changing it is not allowed. 

Preamble 

The purpose of this License is to make a manual, textbook, or other 
functional and useful document "free" in the sense of freedom: to assure 
everyone the effective freedom to copy and redistribute it, with or without 
modifying it, either commercially or noncommercially. Secondarily, this 
License préserves for the author and publisher a way to get crédit for their 
work, while not being considered responsible for modifications made by 
others. 

This License is a kind of "copyleft", which means that dérivative works of 
the document must themselves be free in the same sense. It compléments 
the GNU General Public License, which is a copyleft license designed for 
free software. 

We hâve designed this License in order to use it for manuals for free 
software, because free software needs free documentation: a free program 
should corne with manuals providing the same freedoms that the software 
does. But this License is not limited to software manuals; it can be used for 
any textual work, regardless of subject matter or whether it is published as 
a printed book. We recommend this License principally for works whose 
purpose is instruction or reference. 

1. APPLICABILITY AND DEFINITIONS 

This License applies to any manual or other work, in any medium, that 
contains a notice placed by the copyright holder saying it can be distributed 
under the terms of this License. Such a notice grants a world-wide, royalty- 
free license, unlimited in duration, to use that work under the conditions 
stated herein. The "Document", below, refers to any such manual or work. 
Any member of the public is a licensee, and is addressed as "you". You ac- 
cept the license if you copy, modify or distribute the work in a way requiring 
permission under copyright law. 
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A "Modified Version" of the Document means any work containing the 
Document or a portion of it, either copied Verbatim, or with modifications 
and/or translated into another language. 

A "Secondary Section" is a named appendix or a front-matter section of 
the Document that deals exclusively with the relationship of the publishers 
or authors of the Document to the Document's overall subject (or to related 
matters) and contains nothing that could fall directly within that overall 
subject. (Thus, if the Document is in part a textbook of mathematics, a 
Secondary Section may not explain any mathematics.) The relationship 
could be a matter of historical connection with the subject or with related 
matters, or of legal, commercial, philosophical, ethical or political position 
regarding them. 

The "Invariant Sections" are certain Secondary Sections whose titles 
are designated, as being those of Invariant Sections, in the notice that says 
that the Document is released under this License. If a section does not fit 
the above définition of Secondary then it is not allowed to be designated 
as Invariant. The Document may contain zéro Invariant Sections. If the 
Document does not identify any Invariant Sections then there are none. 

The "Cover Texts" are certain short passages of text that are listed, as 
Front-Cover Texts or Back-Cover Texts, in the notice that says that the 
Document is released under this License. A Front-Cover Text may be at 
most 5 words, and a Back-Cover Text may be at most 25 words. 

A "Transparent" copy of the Document means a machine-readable copy, 
represented in a format whose spécification is available to the general public, 
that is suitable for revising the document straightforwardly with generic text 
editors or (for images composed of pixels) generic paint programs or (for 
drawings) some widely available drawing editor, and that is suitable for input 
to text formatters or for automatic translation to a variety of formats suitable 
for input to text formatters. A copy made in an otherwise Transparent file 
format whose markup, or absence of markup, has been arranged to thwart 
or discourage subséquent modification by readers is not Transparent. An 
image format is not Transparent if used for any substantial amount of text. 
A copy that is not "Transparent" is called "Opaque". 

Examples of suitable formats for Transparent copies include plain ASCII 
without markup, Texinfo input format, LaTeX input format, SGML or XML 
using a publicly available DTD, and standard-conforming simple HTML, 
PostScript or PDF designed for human modification. Examples of trans¬ 
parent image formats include PNG, XCF and JPG. Opaque formats include 
proprietary formats that can be read and edited only by proprietary word 
processors, SGML or XML for which the DTD and/or processing tools are 
not generally available, and the machine-generated HTML, PostScript or 
PDF produced by some word processors for output purposes only. 

The "Title Page" means, for a printed book, the title page itself, plus 
such following pages as are needed to hold, legibly, the material this License 
requires to appear in the title page. For works in formats which do not hâve 
any title page as such, "Title Page" means the text near the most prominent 
appearance of the work's title, preceding the beginning of the body of the 
text. 
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A section "Entitled XYZ" means a named subunit of the Document 
whose title either is precisely XYZ or contains XYZ in parenthèses follow- 
ing text that translates XYZ in another language. (Here XYZ stands for 
a spécifie section name mentioned below, such as "Acknowledgements", 
"Dedications", "Endorsements", or "History".) To "Preserve the Title" of 
such a section when you modify the Document means that it remains a 
section "Entitled XYZ" according to this définition. 

The Document may include Warranty Disclaimers next to the notice 
which States that this License applies to the Document. These Warranty 
Disclaimers are considered to be included by reference in this License, but 
only as regards disclaiming warranties: any other implication that these 
Warranty Disclaimers may hâve is void and has no effect on the meaning 
of this License. 


2. VERBATIM COPVING 

You may copy and distribute the Document in any medium, either com- 
mercially or noncommercially, provided that this License, the copyright no¬ 
tices, and the license notice saying this License applies to the Document are 
reproduced in ail copies, and that you add no other conditions whatsoever 
to those of this License. You may not use technical measures to obstruct 
or control the reading or further copying of the copies you make or dis¬ 
tribute. However, you may accept compensation in exchange for copies. If 
you distribute a large enough number of copies you must also follow the 
conditions in section 3. 

You may also lend copies, under the same conditions stated above, and 
you may publicly display copies. 

3. COPVING IN QUANTITV 

If you publish printed copies (or copies in media that commonly hâve 
printed covers) of the Document, numbering more than 100, and the Doc¬ 
uments license notice requires Cover Texts, you must enclose the copies 
in covers that carry, clearly and legibly, ail these Cover Texts: Front-Cover 
Texts on the front cover, and Back-Cover Texts on the back cover. Both 
covers must also clearly and legibly identify you as the publisher of these 
copies. The front cover must présent the full title with ail words of the title 
equally prominent and visible. You may add other material on the covers in 
addition. Copying with changes limited to the covers, as long as they pre¬ 
serve the title of the Document and satisfy these conditions, can be treated 
as Verbatim copying in other respects. 

If the required texts for either cover are too voluminous to fit legibly, 
you should put the first ones listed (as many as fit reasonably) on the actual 
cover, and continue the rest onto adjacent pages. 

If you publish or distribute Opaque copies of the Document numbering 
more than 100, you must either include a machine-readable Transparent 
copy along with each Opaque copy, or state in or with each Opaque copy 
a computer-network location from which the general network-using public 
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has access to download using public-standard network protocols a complété 
Transparent copy of the Document, free of added material. If you use 
the latter option, you must take reasonably prudent steps, when you begin 
distribution of Opaque copies in quantity, to ensure that this Transparent 
copy will remain thus accessible at the stated location until at least one year 
after the last time you distribute an Opaque copy (directly or through your 
agents or retailers) of that édition to the public. 

It is requested, but not required, that you contact the authors of the 
Document well before redistributing any large number of copies, to give 
them a chance to provide you with an updated version of the Document. 

4. MODIFICATIONS 

You may copy and distribute a Modified Version of the Document under 
the conditions of sections 2 and 3 above, provided that you release the Mod- 
ified Version under precisely this License, with the Modified Version filling 
the rôle of the Document, thus licensing distribution and modification of the 
Modified Version to whoever possesses a copy of it. In addition, you must 
do these things in the Modified Version: 

A. Use in the Title Page (and on the covers, if any) a title distinct from that 
of the Document, and from those of previous versions (which should, if 
there were any, be listed in the History section of the Document). You 
may use the same title as a previous version if the original publisher 
of that version gives permission. 

B. List on the Title Page, as authors, one or more persons or entities 
responsible for authorship of the modifications in the Modified Version, 
together with at least five of the principal authors of the Document (ail 
of its principal authors, if it has fewer than five), unless they release 
you from this requirement. 

C. State on the Title page the name of the publisher of the Modified Ver¬ 
sion, as the publisher. 

D. Preserve ail the copyright notices of the Document. 

E. Add an appropriate copyright notice for your modifications adjacent to 
the other copyright notices. 

F. Include, immediately after the copyright notices, a license notice giving 
the public permission to use the Modified Version under the terms of 
this License, in the form shown in the Addendum below. 

G. Preserve in that license notice the full lists of Invariant Sections and 
required Cover Texts given in the Document's license notice. 

H. Include an unaltered copy of this License. 
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I. Preserve the section Entitled "History", Preserve its Title, and add to 
it an item stating at least the title, year, new authors, and publisher of 
the Modified Version as given on the Title Page. If there is no section 
Entitled "Elistory" in the Document, create one stating the title, year, 
authors, and publisher of the Document as given on its Title Page, then 
add an item describing the Modified Version as stated in the previous 
sentence. 

J. Preserve the network location, if any, given in the Document for pub¬ 
lic access to a Transparent copy of the Document, and likewise the 
network locations given in the Document for previous versions it was 
based on. These may be placed in the "History" section. You may omit 
a network location for a work that was published at least four years 
before the Document itself, or if the original publisher of the version 
it refers to gives permission. 

K. For any section Entitled "Acknowledgements" or "Dedications", Pre¬ 
serve the Title of the section, and preserve in the section ail the sub¬ 
stance and tone of each of the contributor acknowledgements and/or 
dedications given therein. 

L. Preserve ail the Invariant Sections of the Document, unaltered in their 
text and in their titles. Section numbers or the équivalent are not 
considered part of the section titles. 

M. Delete any section Entitled "Endorsements". Such a section may not 
be included in the Modified Version. 

N. Do not retitle any existing section to be Entitled "Endorsements" or to 
conflict in title with any Invariant Section. 

O. Preserve any Warranty Disclaimers. 

If the Modified Version includes new front-matter sections or appendices 
that qualify as Secondary Sections and contain no material copied from the 
Document, you may at your option designate some or ail of these sections 
as invariant. To do this, add their titles to the list of Invariant Sections in 
the Modified Version's license notice. These titles must be distinct from any 
other section titles. 

You may add a section Entitled "Endorsements", provided it contains 
nothing but endorsements of your Modified Version by various parties-for 
example, statements of peer review or that the text has been approved by 
an organization as the authoritative définition of a standard. 

You may add a passage of up to five words as a Front-Cover Text, and 
a passage of up to 25 words as a Back-Cover Text, to the end of the list of 
Cover Texts in the Modified Version. Only one passage of Front-Cover Text 
and one of Back-Cover Text may be added by (or through arrangements 
made by) any one entity. If the Document already includes a cover text for 
the same cover, previously added by you or by arrangement made by the 
same entity you are acting on behalf of, you may not add another; but you 
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may replace the old one, on explicit permission from the previous publisher 
that added the old one. 

The author(s) and publisher (s) of the Document do not by this License 
give permission to use their names for publicity for or to assert or imply 
endorsement of any Modified Version. 

5. COMBINING DOCUMENTS 

You may combine the Document with other documents released un- 
der this License, under the terms defined in section 4 above for modified 
versions, provided that you include in the combination ail of the Invariant 
Sections of ail of the original documents, unmodified, and list them ail as 
Invariant Sections of your combined work in its license notice, and that you 
preserve ail their Warranty Disclaimers. 

The combined work need only contain one copy of this License, and 
multiple identical Invariant Sections may be replaced with a single copy. 
If there are multiple Invariant Sections with the same name but different 
contents, make the title of each such section unique by adding at the end 
of it, in parenthèses, the name of the original author or publisher of that 
section if known, or else a unique number. Make the same adjustment to 
the section titles in the list of Invariant Sections in the license notice of the 
combined work. 

In the combination, you must combine any sections Entitled "History" in 
the various original documents, forming one section Entitled "Elistory"; like- 
wise combine any sections Entitled "Acknowledgements", and any sections 
Entitled "Dedications". You must delete ail sections Entitled "Endorsements". 


6. COLLECTIONS OF DOCUMENTS 

You may make a collection consisting of the Document and other docu¬ 
ments released under this License, and replace the individual copies of this 
License in the various documents with a single copy that is included in the 
collection, provided that you follow the rules of this License for Verbatim 
copying of each of the documents in ali other respects. 

You may extract a single document from such a collection, and distribute 
it individually under this License, provided you insert a copy of this License 
into the extracted document, and follow this License in ali other respects 
regarding Verbatim copying of that document. 

7. AGGREGATION WITH INDEPENDENT 

WORKS 

A compilation of the Document or its dérivatives with other separate 
and independent documents or works, in or on a volume of a storage or 
distribution medium, is called an "aggregate" if the copyright resulting from 
the compilation is not used to limit the legal rights of the compilation's 
users beyond what the individual works permit. When the Document is 
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included in an aggregate, this License does not apply to the other works in 
the aggregate which are not themselves dérivative works of the Document. 

If the Cover Text requirement of section 3 is applicable to these copies 
of the Document, then if the Document is less than one half of the en- 
tire aggregate, the Document's Cover Texts may be placed on covers that 
bracket the Document within the aggregate, or the electronic équivalent of 
covers if the Document is in electronic form. Otherwise they must appear 
on printed covers that bracket the whole aggregate. 

8. TRANSLATION 

Translation is considered a kind of modification, so you may distribute 
translations of the Document under the terms of section 4. Replacing In¬ 
variant Sections with translations requires spécial permission from their 
copyright holders, but you may include translations of some or ail Invariant 
Sections in addition to the original versions of these Invariant Sections. You 
may include a translation of this License, and ail the license notices in the 
Document, and any Warranty Disclaimers, provided that you also include 
the original English version of this License and the original versions of 
those notices and disclaimers. In case of a disagreement between the trans¬ 
lation and the original version of this License or a notice or disclaimer, the 
original version will prevail. 

If a section in the Document is Entitled "Acknowledgements", "Dedica- 
tions", or "History", the requirement (section 4) to Preserve its Title (sec¬ 
tion 1) will typically require changing the actual title. 

9. TERMINATION 

You may not copy, modify, sublicense, or distribute the Document except 
as expressly provided for under this License. Any other attempt to copy, 
modify, sublicense or distribute the Document is void, and will automati- 
cally terminate your rights under this License. However, parties who hâve 
received copies, or rights, from you under this License will not hâve their 
licenses terminated so long as such parties remain in full compliance. 

10. FUTURE REVISIONS OF THIS LICENSE 

The Free Software Foundation may publish new, revised versions of the 
GNU Free Documentation License from time to time. Such new versions 
will be similar in spirit to the présent version, but may differ in detail to 
address new problems or concerns. See http://www.gnu.org/copyleft/. 

Each version of the License is given a distinguishing version number. If 
the Document spécifiés that a particular numbered version of this License 
"or any later version" applies to it, you hâve the option of following the 
terms and conditions either of that specified version or of any later version 
that has been published (not as a draft) by the Free Software Foundation. If 
the Document does not specify a version number of this License, you may 
choose any version ever published (not as a draft) by the Free Software 
Foundation. 
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ADDENDUM: How to use this License for your 

documents 

To use this License in a document you hâve written, include a copy of 
the License in the document and put the following copyright and license 
notices just after the title page: 


Copyright © YEAR YOUR NAME. Permission is granted to copy, 
distribute and/or modify this document under the terms of the 
GNU Free Documentation License, Version 1.2 or any later ver¬ 
sion published by the Free Software Foundation; with no Invariant 
Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy 
of the license is included in the section entitled "GNU Free Docu¬ 
mentation License". 


If you hâve Invariant Sections, Front-Cover Texts and Back-Cover Texts, 
replace the "with ... Texts." line with this: 


with the Invariant Sections being LIST THEIR TITLES, with the 
Front-Cover Texts being LIST, and with the Back-Cover Texts 
being LIST. 


If you hâve Invariant Sections without Cover Texts, or some other com¬ 
bination of the three, merge those two alternatives to suit the situation. 

If your document contains nontrivial examples of program code, we 
recommend releasing these examples in parallel under your choice of free 
software license, such as the GNU General Public License, to permit their 
use in free software. 



History 


25th Sept 2012 (Version 1.4) 

• Paperback édition 1 produced. 

• Added TeXWorks section. 

• Moved "Text editor and Terminal approach", "TeXnicCenter" and "WinEdt" 
sections to new supplementary material. 

• Added hardcopy-related code. 

• Change to KOMA-Script classes (both for examples and for pdf ver¬ 
sions of this document). 

• Changed from using subfloat to subcaption package. 

• Added section on inter-sentence spacing. 

• Moved "Errors" and "Where to get Elelp?" to appendices. 

• Moved section "Downloading and Installing Packages" to new appendix 
chapter. 

• Moved introduction to packages to "Creating a Simple Document". 

• Moved datetime section to "Creating a Simple Document" chapter. (Re- 
moved reference to ukdate package.) 

• Moved babel section to "Structuring Your Document" chapter. 

• Moved graphicx section to its own chapter. 

• Added section on align. 

• Added \cfrac, \substack and amsmath ellipses to maths chapter. 

• Added extensible arrows and \bigl etc to maths chapter. 

• Added booktabs. 

• Moved lengths chapter to section in définitions. 

• Added summary chapter with commands hyperlinked to their défini¬ 
tions in the summary. 

• Changed définitions chapter to use a glossary structure. 

• Moved bibliography into bib file. 
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• Added varioref. 

• Removed dependency on html package (for pdf versions) to avoid con- 
flict between html and varioref (html package functions not defined by 
hyperref now emulated; comment package loaded to provide htmlonly envi¬ 
ronment). 

• Removed image of équation written in Word (Microsoft hâve improved 
their équation rendering) and added link to Murray Sargent III blog [12]. 

• Added section on what a terminal/command prompt is. 

• Added section on auxiliary files. 

• Added section on Perl. 

• Added information about latexmk 

• Mentioned grffile package. 

• Mentioned on-the-fly EPS conversion. 

• Mentioned etoolbox's \appto and babel's \addto. 

• Changed to UTF-8 and mostly changed to using code points instead of 
named entities in HTML files. 

• Moved the document's home page from http : //theoval. cmp. uea. ac. 
uk/~nlct/latex/novices/ to http : //www. dickimaw-books. com/latex/ 
novices/. 


15th Jan 2008 (Version 1.3) 

The main reason behind this change was to increase accessibility and con- 
form to W3C guidelines. If you are experiencing problems relating to ac¬ 
cessibility, please let me know (clearly stating the problem). 

• Corrected error in the university's post code on the title page 

• Added alternative text tags to more of the images, and made some of 
the images hyperlinks to a more detailed description of the image. 

• Added information on how to break ligatures. 

• Moved information on TeX to the introduction, and removed section 
on TeX that was in the "Some Définitions" chapter. 

• Document nodes now hâve permanent names instead of the generic 
node(n).html which ETp;X2HTML generates by default. 

• Went back to using straight double quotes in the HTML document as 
the fancy typographie double quotes are nonstandard. 
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8th May 2007 (Version 1.2) 

• Links to UK FAQ [18] added. 

• OverView made into a separate section, and tidied up a bit. 

• Added some extra définitions: moving arguments and fragile com- 
mands, robust commands, short and long commands. 

• Changed "Text editor and Terminal approach" to deal with Unix-type 
Systems rather than MS-DOS. 

• Moved section on tabular environment. 

• Added section on boxes and mini-pages. 

• Segmented section on font changing commands. 

• Segmented section describing graphicx. 

• Added section on the babel package. 

• Updated and segmented section on downloading and installing new 
packages. 

• Added section on side-by-side figures. 

• Updated section on sub-figures to use the new subfloat package instead 
of the obsolète subfigure package. 

• Added "Need More Help?" chapter. 


Back Cover Text 


(See http://www.gnu.org/licenses/fdl-howto-opt.html#SEC2.) 

If you choose to buy a copy of this book, Dickimaw Books asks for your 
support through buying the Dickimaw Books édition to help cover costs. 
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